Agent skills library for Google Ads workflows

73 skills for AI-powered Google Ads management, built from 15+ years of hands-on experience.
Compatible with Claude Code, Cursor, Codex, and Gemini CLI. Follows the Agent Skills specification.

English | Francais | Espanol | 中文 | Nederlands | Русский | 한국어

---

Why This Repo?

These skills encode what we learned running Google Ads for hundreds of accounts across every industry vertical — from $500/month local businesses to $500K/month ecommerce brands. Every pattern, threshold, and best practice comes from real campaign data and real optimization decisions, not generated from documentation.

The skills power Buddy Agent, the AI advertising agent at googleadsagent.ai, which manages live Google Ads accounts through the API with a 1,000-pattern knowledge base, multi-model routing (Claude, GPT, Gemini), and persistent entity memory.

---

What Does a Skill Look Like?

Every skill is a SKILL.md file with YAML frontmatter per the Agent Skills spec. Here is a real skill from this repo:

---
name: keyword-research
description: >-
  Systematic keyword discovery, expansion, and optimization for Google Ads campaigns.
---

# Keyword Research

## Description

Systematic keyword discovery, expansion, and optimization for Google Ads.
Builds keyword universes from seed keywords through semantic expansion,
competitor mining, search term analysis, and intent-based grouping.

## Use When

- User asks for "keyword research" or "keyword ideas"
- User wants to "expand keywords" or "find new keywords"
- User mentions "negative keywords" or "search term mining"
- User asks about "match types" (broad, phrase, exact)
- User wants to "reduce wasted spend" on irrelevant queries

## Implementation

​```javascript
function assignMatchType(keyword) {
  if (keyword.conversionRate > 0.05 && keyword.volume < 1000)
    return 'EXACT';
  if (keyword.intent === 'transactional' && keyword.wordCount >= 3)
    return 'PHRASE';
  return 'PHRASE';
}
​```

## Platform Compatibility

| Platform    | Supported |
|-------------|-----------|
| Cursor      | ✅        |
| Claude Code | ✅        |
| Codex       | ✅        |
| Gemini CLI  | ✅        |

## Related Skills

- [Ad Copy Generation](../google-ads/ad-copy-generation/)
- [Competitor Analysis](../google-ads/competitor-analysis/)

Every skill follows this structure:

Full format specification: docs/skill-format.md | Official spec: agentskills/agentskills

---

Quick Start

Claude Code (Plugin Marketplace)

Register this repo as a plugin marketplace, then install any skill set:

/plugin marketplace add itallstartedwithaidea/agent-skills

Then install by category:

/plugin install google-ads-skills@googleadsagent-skills
/plugin install ai-agent-engineering-skills@googleadsagent-skills
/plugin install claude-mythos-skills@googleadsagent-skills
/plugin install software-dev-skills@googleadsagent-skills
/plugin install security-skills@googleadsagent-skills
/plugin install all-skills@googleadsagent-skills

Claude Code (Direct)

Point Claude at any skill directly:

/read skills/google-ads/keyword-research/SKILL.md

Cursor

Add the skills/ directory to your workspace. Cursor loads SKILL.md files automatically via YAML frontmatter.

npx skills (works with Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Amp, Antigravity)

npx skills add itallstartedwithaidea/agent-skills

Installs all 73 skills to .agents/skills/ in your project. Compatible with 12+ AI coding agents.

Manual Install

git clone https://github.com/itallstartedwithaidea/agent-skills.git
cd agent-skills

Validate all skills

bash scripts/validate-skills.sh

Count skills by category

bash scripts/count-skills.sh

Each SKILL.md is self-contained. Point your agent at it, and it has everything it needs.

---

Skills Catalog

73 skills across 10 categories:

Category	Skills	What It Covers
Google Ads	12	Audits, keywords, ad copy, bidding, PMax, Shopping, audiences, conversions, budgets, Quality Score, remarketing, competitor analysis
AI Agent Engineering	10	Knowledge base injection, entity memory, multi-model routing, proactive intelligence, MCP servers, parallel orchestration
Claude Mythos	10	Prompt architecture, context engineering, tool mastery, self-healing agents, verification loops, cognitive scaffolding
Software Development	8	Code review, TDD, systematic debugging, git worktrees, brainstorming, subagent-driven development
Scientific Research	8	Data analysis, machine learning, bioinformatics, cheminformatics, geospatial analysis, scientific writing
Web Frontend	6	React best practices, React Native, view transitions, edge deployment, composition patterns, web design
Productivity	6	Workflow orchestration, batch processing, RAG knowledge bases, AI chat studio, low-code generation
Infrastructure	6	Cloudflare Workers, CI/CD pipelines, edge rendering, observability, service discovery, configuration management
Security	4	Agent security scanning, CodeQL/Semgrep, sandbox hardening, secret protection
Media Creative	3	Web asset generation, programmatic video, ML model integration

---

SKILL.md Format

Follows the Agent Skills specification. Every skill has YAML frontmatter and these required sections:

Section	Purpose
YAML frontmatter (name, description)	Machine-readable metadata for discovery and indexing
# Title	Human-readable skill name
## Description	2-5 sentence explanation
## Use When	Bullet list of trigger scenarios
## Implementation	Code snippets, algorithms, procedures
## Platform Compatibility	Cursor / Claude Code / Codex / Gemini support table
## Related Skills	Links to complementary skills

Optional: ## Prerequisites, ## Configuration, ## Best Practices, ## Limitations, ## Keywords

Full specification: docs/skill-format.md

---

Architecture

Buddy Agent loads skills on demand based on user intent matching:

graph TB
    User["User / Advertiser"] --> Buddy["Buddy Agent"]

    Buddy --> Router["Multi-Model Router"]
    Router --> Claude["Claude"]
    Router --> GPT["GPT"]
    Router --> Gemini["Gemini"]

    Buddy --> Tools["Tool Calling"]
    Tools --> GAds["Google Ads API v23"]
    Tools --> WebSearch["Web Search"]
    Tools --> PageScanner["Page Scanner"]

    Buddy --> Skills["Agent Skills (this repo)"]
    Skills --> GoogleAds["Google Ads (12)"]
    Skills --> AgentEng["AI Agent Engineering (10)"]
    Skills --> ClaudeMythos["Claude Mythos (10)"]
    Skills --> SoftwareDev["Software Dev (8)"]
    Skills --> OtherCats["+ 6 more categories"]

    Buddy --> CF["Cloudflare Workers"]
    CF --> KV["KV Store"]
    CF --> DO["Durable Objects"]

Full architecture documentation: docs/architecture.md

---

Contributing

We welcome contributions. See CONTRIBUTING.md for guidelines.

To add a new skill:

1. Create a directory under the appropriate skills/ category
2. Add a SKILL.md with YAML frontmatter (name, description) and required sections
3. Run bash scripts/validate-skills.sh to confirm it passes
4. Submit a pull request

---

Acknowledgments

We studied these open-source projects while building Agent Skills:

Repository	What We Studied
agentskills/agentskills	Official Agent Skills specification by Anthropic
anthropics/skills	Reference skill implementations
obra/superpowers	Agent architecture and autonomous workflow patterns
affaan-m/everything-claude-code	Claude Code best practices
vercel-labs/agent-skills	Skills format specification
K-Dense-AI/scientific-agent-skills	Scientific methodology for skill validation

---

License

MIT License. See LICENSE.

---

Built by John Williams — 15+ years in paid media, Lead at Seer Interactive | Powered by googleadsagent.ai