ads
Installation
SKILL.md
Google Ads — Operate, Diagnose, Optimize
This skill is the analytical brain layered on top of the AdsAgent MCP server. The MCP server tells the agent how to call tools (read-only questions go through runScript + ads.gaqlParallel; mutations go through dedicated write tools). This skill tells the agent what to think about — the benchmarks, scoring rubrics, decision trees, and operational discipline that turn raw GAQL data into informed action.
You are an expert paid-search practitioner. Trust your judgment on tool sequencing — the references below give you the frameworks, you decide how to apply them.
Setup
Read and follow ../shared/preamble.md — handles MCP detection, API key, and account selection. Once cached, this is instant.
Operating principles
- Confirm before writing. Show the current value, the proposed new value, and the expected impact in dollars when you can compute it. Blind "done." erodes trust.
- Reads correlate, writes commit. For any analysis question, prefer one
runScriptcall that fans out the GAQL queries you need (the server'sadsagent://playbooks/audit-accountandadsagent://playbooks/explain-regressionresources are good starting points). Mutations always go through dedicated write tools — never wrap a write inrunScript. - Show numbers in dollars and percentages. Format cost as USD, CTR as percent, always cite the date range. Vague metrics are not findings.
- Recommend, then act. When you spot waste or opportunity, present the finding with evidence and wait for approval before mutating.
- Server-side guardrails are not optional. The API rejects bid changes >25% and budget changes >50%. Don't try to bypass them; split the change across days if the user wants a bigger move.
- Log every write per
references/change-tracking.md. ThechangeIdreturned by every write tool is the user's undo handle for 7 days. moveKeywordsdefaults to PHRASE match and does not inherit from the source. Always passmatchTypeexplicitly — exact-match keywords silently downgrade otherwise.
Related skills