How vuongdiensharing-performance/google-ads-performance-skills works
Google Ads Performance Skills is a model-agnostic collection of auditable marketing workflows, domain knowledge, and evidence-based decision rules. A principal workflow selects a registered Skill, evaluates its related Rules against account context, and produces findings that a Skill’s output contract classifies and prioritizes. A separate GA4 path governs allowlisted query requests, obtains read-only MCP results, and wraps them as provenance-bearing evidence. The README documents the GA4 layering, but the excerpts do not establish a live connection from that integration into Rule Engine decisions; that future link is shown as unverified.
Main entry points: adapter.py Read-only adapter · skill_runtime.py Skill runtime · client.py MCP client · rules Decision Rules
Components 17
Skills and runtime
- Skill workflows
skills - Skill registry
skills/registry.yaml - Skill runtime
scripts/skill_runtime.py - Rule Engine
scripts/rule_engine.py
Decision assets
- Decision Rules
rules - Domain knowledge
knowledge - Output contracts
templates
GA4 evidence policy
- Boundary contract
schemas/boundary-contract.json - Evidence contract
schemas/ga4-evidence-contract.json - Identity and linkage
docs/GA4_MCP_INTEGRATION.md - Query contracts
queries/google_analytics - Provider policy
providers/google_analytics.yaml
GA4 integration
- Read-only adapter
integrations/google_analytics/adapter.py - MCP client
integrations/google_analytics/client.py - Approved GA4 evidence
integrations/google_analytics/adapter.py
Other components
- Agent or user
- Google Analytics MCP
Connections 18
- Agent or user → Skill runtime: runs skill
scripts/skill_runtime.py - Skill runtime → Skill registry: reads registry
scripts/skill_runtime.py - Skill runtime → Rule Engine: evaluates rules
scripts/skill_runtime.py - Skill runtime → Decision Rules: loads rules
scripts/skill_runtime.py - Skill workflows → Output contracts: defines output
README.md - Decision Rules → Domain knowledge: grounded by
README.md - Agent or user → Read-only adapter: requests evidence
- Read-only adapter → MCP client: calls tool
integrations/google_analytics/adapter.py - MCP client → Google Analytics MCP: sends MCP request
integrations/google_analytics/client.py - Google Analytics MCP → MCP client: returns result
- Read-only adapter → Approved GA4 evidence: wraps result
integrations/google_analytics/adapter.py - Query contracts → Read-only adapter: constrains requests
README.md - Provider policy → Read-only adapter: limits tools
README.md - Boundary contract → Evidence contract: precedes
README.md - Evidence contract → Identity and linkage: precedes
README.md - Identity and linkage → Read-only adapter: precedes
README.md - Read-only adapter → Query contracts: checks registered query
README.md - Approved GA4 evidence → Rule Engine: may inform decisions