search-campaign-audit — Google Ads Audit Skill for Claude Code
Audits Google Ads Search campaigns: keyword quality scores, negative keyword gaps, weak ads, wasted match-type spend. Microsoft Ads support included.
npx skills add cognyai/claude-code-marketing-skills --skill search-campaign-audit -a claude-codeWhat search-campaign-audit does
The skill walks through every Search campaign in a Google Ads account and checks quality score components, spending keywords without conversions, duplicate keywords across ad groups, and RSA asset coverage. If Microsoft Ads is connected, it pulls the same numbers through Bing Ads and reports engines side by side.
It runs GAQL queries against Google Ads and calls tool_get_report for Bing. Campaigns losing over 40% of impressions to rank or budget get flagged. Search term spend under 50% on intent terms counts as poor. Quality Score 0 or null means the keyword had too little traffic to score, so it is counted separately.
You need a Cogny Agent subscription at $9/mo and the Cogny MCP gateway. Without it the skill prints setup steps and stops. Google Ads money comes in micros, so every amount gets divided by 1,000,000. An empty GAQL result is zero, not an error.
What it helps with
- Spot keywords with Quality Score ≤4 and read the three components to see why
- Find campaigns losing impressions to rank or budget
- List search terms draining budget with no conversions
- Check for duplicate keywords competing between ad groups
- Run one audit across Google Ads and Microsoft Ads without mixing currencies
Example prompts for the agent
- /search-campaign-audit — run the audit across every Search campaign in the account
- /search-campaign-audit Brand - Exact — audit a single campaign by name or id
How to install search-campaign-audit
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill search-campaign-audit -a claude-code2Manually: put the files in place
~/.claude/skills/search-campaign-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/search-campaign-audit/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill search-campaign-audit -a codex2Manually: put the files in place
.agents/skills/search-campaign-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill search-campaign-audit -a cursor2Manually: put the files in place
.cursor/skills/search-campaign-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cognyai/claude-code-marketing-skills search-campaign-audit2Manually: put the files in place
.github/skills/search-campaign-audit/SKILL.md1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill search-campaign-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/search-campaign-auditManually: put the files in place
.devin/skills/search-campaign-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill search-campaign-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about search-campaign-audit
How do I install search-campaign-audit in Claude Code?
Run npx skills add cognyai/claude-code-marketing-skills --skill search-campaign-audit -a claude-code. The skill lands in ~/.claude/skills/search-campaign-audit/SKILL.md.
What does search-campaign-audit do?
It audits Google Ads Search campaigns: quality scores, search term relevance, negative keyword gaps, ad strength and RSA coverage. Microsoft Ads works too.
What do I need before running it?
A Cogny Agent subscription at $9/mo and the Cogny MCP gateway with Google Ads or Microsoft Ads connected. The skill stops and prints setup steps if Cogny is missing.
