google-ads-scripts — Claude Code skill: features and installation
A reference for writing and debugging Google Ads Scripts in JavaScript, from GAQL queries to Sheets workflows. Use it to automate account tasks and reporting.
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a claude-codeWhat google-ads-scripts does
This skill covers the AdsApp object model, selectors and iterators, GAQL queries, and common script patterns. Ask it to draft or debug code for tasks such as monitoring budgets, finding negative keywords, or logging metrics in Google Sheets.
Scripts run inside the Google Ads interface. They need no external server, API keys, or OAuth, and use JavaScript on the V8 runtime. Examples include error handling and a DRY_RUN flag for account changes. Execution is limited to 30 minutes for a single account and 60 minutes for MCC. npm packages and import/export are unsupported, so code that depends on them will not run in this environment.
What it helps with
- write a script to monitor budget pacing
- find search terms to add as negative keywords
- log account metrics to Google Sheets
- build a GAQL query for a report
- process multiple accounts through MCC
Example prompts for the agent
- Write a Google Ads script to monitor budget pacing.
- Find search terms that I could add as negative keywords.
- Show me how to log Quality Score in Google Sheets.
How to install google-ads-scripts
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a claude-code2Manually: put the files in place
~/.claude/skills/google-ads-scripts/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/google-ads-scripts/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a codex2Manually: put the files in place
.agents/skills/google-ads-scripts/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a cursor2Manually: put the files in place
.cursor/skills/google-ads-scripts/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cognyai/claude-code-marketing-skills google-ads-scripts2Manually: put the files in place
.github/skills/google-ads-scripts/SKILL.md1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a gemini-cli2Platform CLI
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/google-ads-scriptsManually: put the files in place
.devin/skills/google-ads-scripts/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -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 google-ads-scripts
How do I install google-ads-scripts in Claude Code?
Run npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a claude-code. The skill file is at ~/.claude/skills/google-ads-scripts/SKILL.md.
What does google-ads-scripts do?
It helps write and debug JavaScript for Google Ads Scripts. Topics include AdsApp, selectors, GAQL, and automation patterns.
Do Google Ads Scripts need API keys?
Scripts run in the Google Ads interface without an external server, API keys, or OAuth. npm packages are unsupported in the script runtime.