Agent skill

Google Ads Management

by ivangfalco in ivangfalco/ads-skills

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

Custom licenceAuto-check: notesMarketing & SEO

Install Google Ads Management

skills CLI
$ npx skills add ivangfalco/ads-skills --skill google-ads -a claude-code

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

GitHub CLI
$ gh skill install ivangfalco/ads-skills 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/ivangfalco/ads-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/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
279
Token cost
~2.1k tokens
SKILL.md length
879 words
Files
26 (incl. scripts)
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Works in 2 steps: Knowledge Base - Strategic frameworks… → API Scripts - Programmatic Google Ads…
  • Auditing a Google Ads account's performance over the last 30 days
  • SKILL.md covers Methodology, Core Philosophy, Architecture and API Scripts - What You Can Do, plus 5 more sections
  • Runs Python scripts from its folder; calls python

What it does

This skill pairs a Google Ads strategy library with Python scripts that talk to the Google Ads API. The knowledge-base folder holds notes on account structure, bidding, keyword and match types, search terms and negatives, responsive search ads and landing pages, Performance Max for B2B, and benchmarks. The method is intent-first: start with high-intent keywords, prove the unit economics, then widen out to lower-intent and awareness traffic.

The scripts folder covers both reading and writing: an account overview with period comparison, campaign and keyword performance, listings of campaigns and ads, a search terms audit, and creating or updating campaigns, ad groups, responsive search ads and keywords, including negatives. Several of these change a live account through the API. Credentials live in scripts/.env, and api-reference.md explains the setup.

When your agent uses it

  • Auditing a Google Ads account's performance over the last 30 days
  • Reviewing search terms to find wasted spend and negative keywords
  • Creating a search campaign, ad group and responsive search ad from the command line
  • Planning keyword structure and bidding for a B2B demand generation account

Example prompts

  • “Give me a snapshot of my Google Ads account for the last 30 days compared with the previous period.”
  • “Pull the search terms report for terms with no conversions and at least 3 clicks, then propose negatives.”
  • “Create a branded search campaign with a daily budget of 50 and one high-intent ad group.”

Requirements

  • Python to run the scripts in scripts/
  • Google Ads API credentials configured in scripts/.env

Workflow steps

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

  1. Knowledge Base - Strategic frameworks and campaign planning (knowledge-base/)
  2. API Scripts - Programmatic Google Ads management (scripts/)

What it can do on your machine

Read from SKILL.md and the folder at commit 558c4db. 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

    Ships 8 files in scripts/ (Python, from the files we listed), which the agent can run.

    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 Management loads about 2.1k tokens when it runs. Until then it costs about 112 tokens; SKILL.md has 879 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:33
    es:** Credentials configured in `scripts/.env`. See `api-reference.md` for setup.

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); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 879 words (~2,138 tokens).

“Orchestrator for all Google Ads tasks. Combines strategic knowledge with programmatic API access for full campaign management.”

— opening of SKILL.md by ivangfalco, Custom licence
name
google-ads

Read the full SKILL.md on GitHub

Files

SKILL.md and 25 other files (scripts) in .claude/skills/google-ads of ivangfalco/ads-skills.

  • SKILL.md
  • api-reference.md
  • knowledge-base/account-structure.md
  • knowledge-base/benchmarks-and-measurement.md
  • knowledge-base/bidding-strategy.md
  • knowledge-base/cheatsheet-overview.md
  • knowledge-base/intent-first-strategy.md
  • knowledge-base/keyword-and-match-types.md
  • knowledge-base/performance-max-b2b.md
  • knowledge-base/rsa-and-landing-pages.md
  • knowledge-base/search-terms-and-negatives.md
  • scripts/README.md
  • scripts/account_overview.py
  • scripts/add_keywords.py
  • scripts/client.py
  • scripts/config.py
  • scripts/create_ad.py
  • scripts/create_ad_group.py
  • scripts/create_campaign.py
  • … and 7 more

Open the folder on GitHubat commit 558c4db

Compare with similar skills

Google Ads Management 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 Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Ads Management this skillivangfalco/ads-skills279—~2.1kAutomated safety check: NotesCustom licence
Google AdsaAAaqwq/AGI-Super-Team1051 repos~1.4kAutomated safety check: PassMIT
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT
Meridian Budget Optimizationgoogle/meridian1.6k—~1.1kAutomated safety check: PassApache-2.0
Campaign Analyticsalirezarezvani/claude-skills28k1 repos~2.1kAutomated safety check: PassMIT
Google Ads AuditAgriciDaniel/claude-ads9.8k—~799Automated safety check: PassMIT

Similar skills

  • Google Ads

    aAAaqwq/AGI-Super-Team

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

    105 GitHub starsUsed in 1 repo~1.4k tokens
    Marketing & SEOAuto-check passed
  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check: notes
  • Official

    Reopens a fitted Meridian MMM from a saved file and runs budget allocation scenarios, producing an HTML report and a Python script that repeats the run.

    1.6k GitHub stars~1.1k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

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

    AgriciDaniel/claude-ads

    Audits a Google Ads account across measurement, search terms, structure, creative, bidding, budgets and policy, and keeps every change as a draft.

    9.8k GitHub stars~799 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Sync Client Libs

    googleads/google-ads-api-developer-assistant

    Discovers Google Ads client libraries under clientlibs, verifies installed versions against GitHub latest releases, and automatically updates outdated codebases.

    100 GitHub stars~537 tokensUpdated 23 days ago
    Marketing & SEOAuto-check passed

More from ivangfalco/ads-skills

  • LinkedIn Ads Management

    ivangfalco/ads-skills

    Routes LinkedIn Ads work for B2B SaaS to the right playbook: campaign planning, performance analysis, account audits, creative, scaling and account-based campaigns.

    279 GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed
  • Meta Ads for B2B

    ivangfalco/ads-skills

    Guides B2B campaigns on Meta (Facebook and Instagram): audience data, campaign structure, creative testing, lead forms and account audits for SaaS lead generation.

    279 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Ads Skills Onboarding

    ivangfalco/ads-skills

    Interactive setup flow that confirms the user is in Claude Code, gathers API credentials for LinkedIn, Meta and Google Ads, tests the connections and explains the ads approach.

    279 GitHub stars~2.3k tokensUpdated 2 mo ago
    Auto-check: notes

Categories

Questions about Google Ads Management

What does Google Ads Management do?

Manages Google Ads accounts with Python scripts for the Google Ads API, backed by an intent-first B2B strategy knowledge base. This skill pairs a Google Ads strategy library with Python scripts that talk to the Google Ads API. The knowledge-base folder holds notes on account structure, bidding, keyword and match types, search terms and negatives, responsive search ads and landing pages, Performance Max for B2B, and benchmarks.

When should I use Google Ads Management?

Google Ads Management fits situations like: auditing a Google Ads account's performance over the last 30 days; reviewing search terms to find wasted spend and negative keywords; creating a search campaign, ad group and responsive search ad from the command line; planning keyword structure and bidding for a B2B demand generation account.

How do I install Google Ads Management in Claude Code?

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

How do I install Google Ads Management in Codex?

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

Can I use Google Ads Management 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 ivangfalco/ads-skills --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 Management need to run?

Going by SKILL.md and its folder, Google Ads Management needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python to run the scripts in scripts/; Google Ads API credentials configured in scripts/.env.

Does Google Ads Management 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 Management safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Google Ads Management use?

Google Ads Management has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Google Ads Management use?

About 2.1k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Ads Management?

Skills that share tags, products or a category with Google Ads Management: Google Ads (aAAaqwq/AGI-Super-Team, 105 stars), Blog Google (AgriciDaniel/claude-blog, 2.3k stars), Meridian Budget Optimization (google/meridian, 1.6k stars) and Campaign Analytics (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Ads Management?

ivangfalco (a GitHub user) maintains it in ivangfalco/ads-skills, which has 279 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on July 15, 2026.

Source: ivangfalco/ads-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.