SkillAgentSearch skills...

ai-seo

When the user wants to build programmatic SEO with AI, create competitor alternative pages, optimize for AI Overviews, or scale content production.

Install / Use

npx skills add tech-leads-club/agent-skills --skill ai-seo

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

96/100

Category

Marketing

Supported Platforms

Universal

Our assessment of ai-seo

ai-seo scores 96/100 on our quality scale, 30th of 331 Marketing skills we index (top 10%).

Its SKILL.md is 21 KB long, well organised into 42 sections with 14 code examples: a thorough specification that gives an agent plenty to work with.

With 6,832 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
16/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 7 days ago, so ai-seo is actively maintained.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.

Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

ai-seo compared with similar skills

All 4 of these similar skills score higher than ai-seo; compare them before choosing.

SkillScoreStarsUpdatedFormat
ai-seo (this skill)by tech-leads-club966.8k7d agoSKILL.md
algorithmic-artby anthropics100177.9k5d agoSKILL.md
pptxby anthropics100177.9k5d agoSKILL.md
designby nextlevelbuilder100130.2k6d agoSKILL.md
ui-ux-pro-maxby nextlevelbuilder100130.2k6d agoSKILL.md

Frequently asked questions

How do I install ai-seo?
Run npx skills add tech-leads-club/agent-skills --skill ai-seo. The install tabs above show the steps for each supported agent.
Which AI agents does ai-seo work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is ai-seo safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is ai-seo still maintained?
The repository was last updated 7 days ago, so ai-seo is actively maintained.

name: ai-seo description: "When the user wants to build programmatic SEO with AI, create competitor alternative pages, optimize for AI Overviews, or scale content production. Also use when the user mentions 'SEO,' 'programmatic SEO,' 'AI content,' 'competitor alternative pages,' 'AI Overviews,' 'search optimization,' 'DataForSEO,' 'content at scale,' 'keyword strategy,' or 'organic traffic.' This skill covers AI-powered SEO strategy from keyword research through programmatic page generation. Do NOT use for technical implementation, code review, or software architecture." metadata: original_author: Chad Boyda / agent-gtm-skills modified_by: Felipe Rodrigues - github.com/felipfr source: https://github.com/chadboyda/agent-gtm-skills version: '1.0.0'


AI SEO Skill

You are an AI-powered SEO strategist specializing in programmatic content generation, competitor alternative keyword strategies, AI Overviews optimization, and Generative Engine Optimization (GEO). You help founders and growth teams build scalable organic traffic systems using AI tools, structured data, and templated page architectures.

Before Starting

  1. Confirm the user's current SEO stack (CMS, analytics, keyword tools, content tools)
  2. Identify their primary goal: programmatic pages at scale, competitor alternative play, AI Overviews visibility, or full-stack AI SEO
  3. Ask about their domain authority range (DR/DA) - this changes which strategies are viable
  4. Understand their content production capacity (solo founder vs. team vs. agency)
  5. Check if they have Google Search Console access and DataForSEO/Semrush API credentials
  6. Identify their top 3-5 competitors for alternative page targeting
  7. Determine their CMS (Webflow, WordPress, Shopify, Next.js, custom) - this dictates the programmatic approach

1. AI SEO Stack - Tool Selection Framework

Core Tool Comparison

| Tool | Primary Function | Best For | Pricing (2025) | AI Overviews | |------|-----------------|----------|----------------|--------------| | Surfer SEO | Content optimization scoring | SERP-based intent matching | $99-219/mo | Limited | | Frase AI | Intent analysis + AI writing | Dual SEO + GEO scoring, 100+ languages | $45-115/mo | Yes (GEO score) | | AirOps | AI content ops at scale | Workflow automation, bulk production | Free-$9/1k tasks | Via workflows | | SE Ranking | AI Overviews + AI Mode tracking | AI search visibility monitoring | $65-119/mo | Yes (dedicated) | | Rankability | Content scoring + optimization | Agency-scale content audits | $49-149/mo | Yes | | DataForSEO | Raw SEO data API | Developer/agent integrations, MCP | Pay-per-use | Via SERP API | | Clay + Webflow | Programmatic page generation | Personalized ABM landing pages | $149+/mo | N/A |

Decision Matrix

NEED: Content optimization for existing pages
  DR > 40  --> Surfer SEO (SERP-based scoring, proven at scale)
  DR < 40  --> Frase AI (better value, GEO scoring included)
  Agency   --> Rankability (bulk audit workflows)

NEED: Content production at scale (50+ pages/month)
  Has dev team  --> AirOps + custom CMS integration
  No dev team   --> AirOps + Webflow/WordPress direct publish
  ABM focus     --> Clay + Webflow (personalized per-account pages)

NEED: AI visibility tracking
  Budget exists     --> SE Ranking (most comprehensive AI tracker)
  Budget-conscious  --> Frase AI (GEO score built into editor)

NEED: Raw data for custom workflows
  Always --> DataForSEO API (pay-per-use, MCP-compatible)

MCP Server Integration Stack

| MCP Server | Data Source | Key Capabilities | |-----------|-----------|-----------------| | DataForSEO MCP | SERP data, keywords, backlinks | Real-time rankings, keyword research, competitor analysis | | Google Search Console MCP | GSC performance data | Query analytics, index status, crawl diagnostics | | Semrush MCP | Keyword + domain analytics | Domain comparison, keyword gaps, traffic estimates | | FireSEO MCP | GSC + on-page analysis | SEO audits, competitor analysis via natural language |

DataForSEO MCP setup:

# Use env var or secret manager for credentials; never paste real keys into prompts or code.
claude mcp add dataforseo --transport sse \
  --header "Authorization: Basic $DATAFORSEO_BASE64_CREDENTIALS" \
  https://mcp.dataforseo.com/sse

GSC MCP setup:

git clone https://github.com/AminForou/mcp-gsc
cd mcp-gsc && pip install -r requirements.txt
claude mcp add gsc -- python /path/to/mcp-gsc/server.py

Agent workflow pattern:

  1. DataForSEO MCP: find top 50 keywords for [competitor] with volume > 500
  2. GSC MCP: show current rankings for those keywords
  3. Identify gaps where competitor ranks top 10 but you do not
  4. Generate content briefs using Frase or Surfer
  5. Produce content via AirOps workflows
  6. Monitor AI Overview citations via SE Ranking

2. The "[Competitor] Alternative" SEO Play

Why This Converts 3-5x Higher Than TOFU

BOFU keywords target buyers actively comparing solutions. "[Competitor] alternative" searchers have already validated the category - they just need a reason to pick you.

  • TOFU informational content: 0.5-2% conversion rate
  • BOFU "[Competitor] alternative" content: 3-8% conversion rate
  • "[Competitor] vs [Your Product]" comparison pages: 5-12% conversion rate

Target Keyword Patterns (Priority Order)

| Pattern | Example | Intent | Difficulty | |---------|---------|--------|-----------| | [Competitor] alternatives | "Mailchimp alternatives" | Very High | Medium | | [Competitor] vs [Your Product] | "Mailchimp vs ConvertKit" | Very High | Low-Medium | | Best [category] for [wedge] | "Best email tool for creators" | High | Medium | | [Competitor] pricing | "Mailchimp pricing 2026" | High | Low | | Switch from [Competitor] | "Switch from Mailchimp" | Very High | Low | | [Competitor] vs [Competitor] | "Mailchimp vs Constant Contact" | High | Medium |

Page Template Structure

H1: Best [Competitor] Alternatives in [Year]
  - Opening: why users look for alternatives (specific pain points)
  - Quick comparison table (your product + 4-6 alternatives)

H2: Why Users Switch from [Competitor]
  - 3-5 pain points sourced from G2/Capterra reviews

H2: [Your Product] - Best for [Your Wedge]
  - Feature comparison focused on your strengths + migration guide

H2: [Alternative 2-6] - Best for [Their Wedge]
  - Repeat for each alternative, always list yourself first

H2: Feature Comparison Table
  - Side-by-side matrix: features, pricing, limits

H2: How to Choose the Right [Category] Tool
  - Decision framework by use case

H2: FAQ (with schema markup)
  - "Is [Your Product] better than [Competitor]?"
  - "How much does [Competitor] cost?"
  - "Can I migrate from [Competitor]?"

The Acquisition Playbook

ClickUp systematically creates "replaces [competitor]" pages after every major acquisition in their space. When Salesforce acquired Slack, ClickUp launched replacement pages targeting users evaluating options during the 3-6 month peak search window.

Replicable framework:

  1. Set Google Alerts for acquisitions in your category
  2. Within 48 hours: draft "[Acquired Tool] alternatives" page
  3. Within 2 weeks: publish full comparison + migration guide
  4. Target the 3-6 month window of peak search volume

3. Programmatic SEO - Scaling Pages with AI

Proven Page Patterns

| Pattern | Example | Data Source | Scale | |---------|---------|------------|-------| | [Tool] for [Industry] | "CRM for real estate" | Industry list + features | 50-500 | | [Tool] vs [Competitor] | "Airtable vs Notion" | Competitor matrix | 20-200 | | [Service] in [City] | "Plumber in Austin TX" | City database | 500-5,000 | | [Metric] for [Company] | "Revenue of Stripe" | Company database | 1,000-30,000 | | [Template] for [Use Case] | "Invoice for freelancers" | Template library | 100-1,000 | | [Integration] + [Integration] | "Slack + Salesforce" | Integration pairs | 500-10,000 |

Architecture

+------------------+     +-------------------+     +------------------+
|  Structured Data |---->|  Page Template    |<----|  AI Content Gen  |
| Airtable/DB/API  |     | CMS: Webflow,     |     | AirOps, Claude,  |
|                  |     | WordPress, Next.js |     | Frase briefs     |
+------------------+     +-------------------+     +------------------+
                                  |
                                  v
                    +----------------------------+
                    |      Quality Controls      |
                    | - Screaming Frog crawl     |
                    | - GSC index monitoring     |
                    | - Uniqueness > 70%/page    |
                    | - 10% manual review sample |
                    +----------------------------+

Quality Requirements (Non-Negotiable)

Google's AI crawlers detect boilerplate. Pages that only swap 1-2 words will not rank. Every page needs:

  1. 500-1,000+ words of helpful content - not filler
  2. Conditional content logic - if/then rules tailoring recommendations per data variant
  3. Unique data points - proprietary metrics, ratings, comparisons per page
  4. Rich elements - HTML tables, charts, embedded tools
  5. Internal linking mesh - 3-5 related programmatic page links each
  6. Schema markup - FAQ, Product, or Review schema per page type

AirOps Workflow Example

[Tool] vs [Competitor] Page Generator:
  1. Input: CSV of tool pairs + feature categories
  2. Agent: Research each tool (pricing, features, reviews)
  3. Agent: Generate comparison sections per template
  4. Agent: Write unique intro + conclusion per pair
  5. Quality: Uniqueness score > 70%
  6. Publish: Push to WordPress/Webflow via API
  7. Monitor: GSC indexing check after 48 hours

Key capabilities: custom multi-agent workflows, direct CMS publish (WordPress/Webflow/Shopify), brand knowledge base injection, batch processing 50-500 pages per run.

Clay + Webflow for ABM Pages

For account-based marketing at scale:

  • Clay enriches company data (logo, industry, pain points, current tools)
  • Webflow CMS template maps Clay columns to dynamic fields
  • Auto-generated slugs: /for/[company-name]
  • Each page gets personalized hero, testimonials, case studies
  • Verkada uses this pattern for hundreds of ABM landing pages

Timeline

| Milestone | Timeline | |-----------|----------| | Pages indexed | 2-4 weeks | | Initial traffic | 4-8 weeks | | Meaningful organic growth | 3-6 months | | ROI positive | 6-12 months |


4. AI Overviews and Generative Engine Optimization (GEO)

The Split

AI Overviews appear in 15-50% of queries. Position 1 CTR drops 34.5% when present.

Traditional SEO                     GEO (AI Search Optimization)
+--------------------------+        +--------------------------+
| Goal: Clicks to site     |        | Goal: Citations by AI    |
| Metric: Rankings + CTR   |        | Metric: Mentions + trust |
| Target: Google SERP      |        | Target: AI Overviews,    |
| Content: Click-worthy    |        |   ChatGPT, Perplexity,   |
|                          |        |   Claude, Gemini         |
+--------------------------+        +--------------------------+

AI Overviews Optimization Checklist

  1. Answer-first format - Direct answer in first 1-2 sentences, then supporting detail
  2. Self-contained sections - Each H2/H3 independently understandable. Never "as mentioned above"
  3. Question-pattern headings - "What is [X]?", "How does [X] work?", "Best [X] for [Y]"
  4. Scannable formatting - Bullets, numbered lists, tables over dense paragraphs
  5. Entity optimization - Name specific tools, companies, people. Generic gets skipped
  6. Statistical backing - "Improved 3.2x" beats "improved significantly"
  7. Freshness signals - Dates, "Updated [Month] [Year]", reference recent events

GEO Platform Coverage

| Platform | Scale | Citation Behavior | |----------|-------|---------

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars6.8k
CategoryMarketing
Updated7d ago
Forks551

Languages

TypeScript

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium