Agent skill

Google Ads

by aAAaqwq in aAAaqwq/AGI-Super-Team

Query, audit, and optimize Google Ads campaigns. An agent skill from aAAaqwq/AGI-Super-Team.

MITAuto-check passedMarketing & SEO

Install Google Ads

skills CLI
$ npx skills add aAAaqwq/AGI-Super-Team --skill google-ads -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aAAaqwq/AGI-Super-Team google-ads --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aAAaqwq/AGI-Super-Team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-ads .claude/skills/google-ads && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-ads
GitHub stars
105
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
283 words
Files
4 (incl. references)
Skills in repo
167
Repo updated
First seen
Licence
MIT

At a glance

Query, audit, and optimize Google Ads campaigns. An agent skill from aAAaqwq/AGI-Super-Team.

  • Works in 2 steps: API Mode - If user has google-ads.yaml… → Browser Mode - If user says "I don't…
  • Asked to check ad performance
  • SKILL.md covers Mode Selection, Browser Automation Mode…, API Mode (Power Users) and Audit Checklist, plus 2 more sections
  • Calls python

What it does

Google Ads is an agent skill from aAAaqwq/AGI-Super-Team. Query, audit, and optimize Google Ads campaigns. Supports two modes: (1) API mode for bulk operations with google-ads Python SDK, (2) Browser automation mode for users without API access - just attach a browser tab to ads.google.com. Use when asked to check ad performance, pause campaigns/keywords, find wasted spend, audit conversion tracking, or optimize Google Ads accounts.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `.clawhub/origin.json`, `references/api-setup.md` and `references/browser-workflows.md`).

It sits in Marketing & SEO, covering Paid advertising, Browser automation and Marketing analytics. It works with Google Ads and Python. The repository describes itself as: An installable, cross-framework AI organization: C-suite agents, expert subagents, curated skills, independent review, and one-command setup across 18 AI client/runtime adapters. The licence is MIT.

When your agent uses it

  • Asked to check ad performance
  • Pause campaigns/keywords
  • Find wasted spend
  • Audit conversion tracking

Example prompts

  • “/google-ads”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. API Mode - If user has google-ads.yaml configured or GOOGLE_ADS_* env vars
  2. Browser Mode - If user says "I don't have API access" or just wants quick checks

What it can do on your machine

Read from SKILL.md and the folder at commit 331ecd3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Ads loads about 1.4k tokens when it runs, and up to ~4.8k if it reads all its reference files. Until then it costs about 97 tokens; SKILL.md has 283 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aAAaqwq/AGI-Super-Team at commit 331ecd3, republished under its MIT licence (© aAAaqwq). 283 words, ~1,369 tokens.

Download SKILL.mdSave it as .claude/skills/google-ads/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
google-ads
description
Query, audit, and optimize Google Ads campaigns. Supports two modes: (1) API mode for bulk operations with google-ads Python SDK, (2) Browser automation mode for users without API access - just attach a browser tab to ads.google.com. Use when asked to check ad performance, pause campaigns/keywords, find wasted spend, audit conversion tracking, or optimize Google Ads accounts.

Google Ads Skill

Manage Google Ads accounts via API or browser automation.

Mode Selection

Check which mode to use:

  1. API Mode - If user has google-ads.yaml configured or GOOGLE_ADS_* env vars
  2. Browser Mode - If user says "I don't have API access" or just wants quick checks
bash
# Check for API config
ls ~/.google-ads.yaml 2>/dev/null || ls google-ads.yaml 2>/dev/null

If no config found, ask: "Do you have Google Ads API credentials, or should I use browser automation?"


Browser Automation Mode (Universal)

Requirements: User logged into ads.google.com in browser

Setup
  1. User opens ads.google.com and logs in
  2. User clicks Clawdbot Browser Relay toolbar icon (badge ON)
  3. Use browser tool with profile="chrome"
Common Workflows
Get Campaign Performance
1. Navigate to: ads.google.com/aw/campaigns
2. Set date range (top right date picker)
3. Snapshot the campaigns table
4. Parse: Campaign, Status, Budget, Cost, Conversions, Cost/Conv
Find Zero-Conversion Keywords (Wasted Spend)
1. Navigate to: ads.google.com/aw/keywords
2. Click "Add filter" → Conversions → Less than → 1
3. Click "Add filter" → Cost → Greater than → [threshold, e.g., $500]
4. Sort by Cost descending
5. Snapshot table for analysis
Pause Keywords/Campaigns
1. Navigate to keywords or campaigns view
2. Check boxes for items to pause
3. Click "Edit" dropdown → "Pause"
4. Confirm action
Download Reports
1. Navigate to desired view (campaigns, keywords, etc.)
2. Click "Download" icon (top right of table)
3. Select format (CSV recommended)
4. File downloads to user's Downloads folder

For detailed browser selectors: See references/browser-workflows.md


API Mode (Power Users)

Requirements: Google Ads API developer token + OAuth credentials

Setup Check
bash
# Verify google-ads SDK
python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')"

# Check config
cat ~/.google-ads.yaml
Common Operations
Query Campaign Performance
python
from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage()
ga_service = client.get_service("GoogleAdsService")

query = """
    SELECT campaign.name, campaign.status,
           metrics.cost_micros, metrics.conversions,
           metrics.cost_per_conversion
    FROM campaign
    WHERE segments.date DURING LAST_30_DAYS
    ORDER BY metrics.cost_micros DESC
"""

response = ga_service.search(customer_id=CUSTOMER_ID, query=query)
Find Zero-Conversion Keywords
python
query = """
    SELECT ad_group_criterion.keyword.text,
           campaign.name, metrics.cost_micros
    FROM keyword_view
    WHERE metrics.conversions = 0
      AND metrics.cost_micros > 500000000
      AND segments.date DURING LAST_90_DAYS
    ORDER BY metrics.cost_micros DESC
"""
Pause Keywords
python
operations = []
for keyword_id in keywords_to_pause:
    operation = client.get_type("AdGroupCriterionOperation")
    operation.update.resource_name = f"customers/{customer_id}/adGroupCriteria/{ad_group_id}~{keyword_id}"
    operation.update.status = client.enums.AdGroupCriterionStatusEnum.PAUSED
    operations.append(operation)

service.mutate_ad_group_criteria(customer_id=customer_id, operations=operations)

For full API reference: See references/api-setup.md


Audit Checklist

Quick health check for any Google Ads account:

CheckBrowser PathWhat to Look For
Zero-conv keywordsKeywords → Filter: Conv<1, Cost>$500Wasted spend
Empty ad groupsAd Groups → Filter: Ads=0No creative running
Policy violationsCampaigns → Status columnYellow warning icons
Optimization ScoreOverview page (top right)Below 70% = action needed
Conversion trackingTools → ConversionsInactive/no recent data

Output Formats

When reporting findings, use tables:

markdown
## Campaign Performance (Last 30 Days)
| Campaign | Cost | Conv | CPA | Status |
|----------|------|------|-----|--------|
| Branded  | $5K  | 50   | $100| ✅ Good |
| SDK Web  | $10K | 2    | $5K | ❌ Pause |

## Recommended Actions
1. **PAUSE**: SDK Web campaign ($5K CPA)
2. **INCREASE**: Branded budget (strong performer)

Troubleshooting

Browser Mode Issues
  • Can't see data: Check user is on correct account (top right account selector)
  • Slow loading: Google Ads UI is heavy; wait for tables to fully load
  • Session expired: User needs to re-login to ads.google.com
API Mode Issues
  • Authentication failed: Refresh OAuth token, check google-ads.yaml
  • Developer token rejected: Ensure token is approved (not test mode)
  • Customer ID error: Use 10-digit ID without dashes

© aAAaqwq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/google-ads of aAAaqwq/AGI-Super-Team.

  • SKILL.md
  • .clawhub/origin.json
  • references/api-setup.md
  • references/browser-workflows.md

Open the folder on GitHubat commit 331ecd3

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aAAaqwq/AGI-Super-Team, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Google Ads next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Ads compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Ads this skillaAAaqwq/AGI-Super-Team1051 repos~1.4kAutomated safety check: PassMIT
Google Ads Managementivangfalco/ads-skills279—~2.1kAutomated safety check: NotesCustom licence
Google Adsarnabbagxd/Brand-building-skills724—~3.1kAutomated safety check: PassMIT
Google Adszapier/connectors176—~3.7kAutomated safety check: PassElastic-2.0
Share Of Voiceindranilbanerjee/digital-marketing-pro8591 repos~3.7kAutomated safety check: PassMIT
Google Ads Auditcognyai/claude-code-marketing-skills104—~2.6kAutomated safety check: PassNone

Similar skills

  • Google Ads Management

    ivangfalco/ads-skills

    Manages Google Ads accounts with Python scripts for the Google Ads API, backed by an intent-first B2B strategy knowledge base.

    279 GitHub stars~2.1k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check: notes
  • Google Ads

    arnabbagxd/Brand-building-skills

    Plan, build, and optimize Google Ads campaigns — Search, Shopping, Performance Max, Display, and YouTube — including keyword research, match types, bidding strategy, Quality Score, ad extensions…

    724 GitHub stars~3.1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Google Ads

    zapier/connectors

    Official

    Agent-callable Google Ads tools — search campaigns, ad groups, and ads via GAQL, build performance reports, manage campaign status and budgets, and set up conversion tracking.

    176 GitHub stars~3.7k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Share Of Voice

    indranilbanerjee/digital-marketing-pro

    Calculate share of voice against named competitors across four dimensions — organic (volume-weighted keyword visibility), paid (Google Ads auction insights), social (mention volume with sentiment…

    859 GitHub starsUsed in 1 repo~3.7k tokens
    Marketing & SEOAuto-check passed
  • Google Ads Audit

    cognyai/claude-code-marketing-skills

    Comprehensive Google Ads account audit — campaign structure, budget pacing, conversion tracking, wasted spend — across every campaign type, ranked by estimated $ impact

    104 GitHub stars~2.6k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Utm Builder

    cognyai/claude-code-marketing-skills

    UTM Parameter Strategy & Builder — naming conventions, GA4 channel grouping rules, auto-tagging, common mistakes, and BigQuery validation queries

    104 GitHub stars~4.3k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check: notes

More from aAAaqwq/AGI-Super-Team

All 167 skills in this repo
  • Content Creator

    aAAaqwq/AGI-Super-Team

    Create SEO-optimized marketing content with consistent brand voice.

    105 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Financial Calculator

    aAAaqwq/AGI-Super-Team

    Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest.

    105 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Bankr Signals

    aAAaqwq/AGI-Super-Team

    Transaction-verified trading signals on Base blockchain. An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub starsUsed in 2 repos~3.3k tokens
    Auto-check passed
  • Erc 8004

    aAAaqwq/AGI-Super-Team

    Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents).

    105 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Auto-check passed
  • Zsxq Smart Publish

    aAAaqwq/AGI-Super-Team

    Publish and manage content on 知识星球 (zsxq.com). An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Google Ads

What does Google Ads do?

Query, audit, and optimize Google Ads campaigns. An agent skill from aAAaqwq/AGI-Super-Team. Google Ads is an agent skill from aAAaqwq/AGI-Super-Team. Query, audit, and optimize Google Ads campaigns.

When should I use Google Ads?

Google Ads fits situations like: asked to check ad performance; pause campaigns/keywords; find wasted spend; audit conversion tracking.

How do I install Google Ads in Claude Code?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill google-ads -a claude-code`. Or copy the skill folder (skills/google-ads in aAAaqwq/AGI-Super-Team) into .claude/skills/google-ads in your project. Claude Code loads it when a task matches its description.

How do I install Google Ads in Codex?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill google-ads -a codex`. Or copy the skill folder (skills/google-ads in aAAaqwq/AGI-Super-Team) into .agents/skills/google-ads in your project. Codex loads it when a task matches its description.

Can I use Google Ads in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aAAaqwq/AGI-Super-Team --skill google-ads -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-ads, .gemini/skills/google-ads, .github/skills/google-ads and .opencode/skills/google-ads in your project.

What does Google Ads need to run?

Going by SKILL.md and its folder, Google Ads needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Google Ads access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Google Ads safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Google Ads use?

Google Ads is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Ads use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Google Ads?

Skills that share tags, products or a category with Google Ads: Google Ads Management (ivangfalco/ads-skills, 279 stars), Google Ads (arnabbagxd/Brand-building-skills, 724 stars), Google Ads (zapier/connectors, 176 stars) and Share Of Voice (indranilbanerjee/digital-marketing-pro, 859 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Ads?

aAAaqwq (a GitHub user) maintains it in aAAaqwq/AGI-Super-Team, which has 105 GitHub stars. The repository holds 167 skills in this directory. The repository was last updated on October 8, 2026.

Source: aAAaqwq/AGI-Super-Team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.