ai-seo
The ai-seo skill provides AI-powered SEO strategy for programmatic content generation, competitor alternative targeting, and AI Overviews optimization. Use it when scaling organic traffic through templated page architectures, keyword research workflows, and generative engine optimization, or when users mention programmatic SEO, content at scale, or AI-driven search visibility. The skill excludes technical implementation and code architecture work.
git clone --depth 1 https://github.com/tech-leads-club/agent-skills /tmp/ai-seo && cp -r /tmp/ai-seo/packages/skills-catalog/skills/(gtm)/ai-seo ~/.claude/skills/ai-seoSKILL.md
# 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:** ```bash # 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:** ```bash 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]?" ```
Audit and improve web accessibility following WCAG 2.1 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible". Do NOT use for SEO (use seo), performance (use core-web-vitals), or comprehensive site audits covering multiple areas (use web-quality-audit).
When the user wants to build an AI-powered outreach system, write cold emails, improve deliverability, or scale personalized outreach. Also use when the user mentions 'cold email,' 'cold outreach,' 'outreach automation,' 'Instantly,' 'Smartlead,' 'Clay,' 'email sequences,' 'deliverability,' 'personalization at scale,' 'reply rate,' or 'outreach stack.' This skill covers the complete AI cold outreach system from signal detection through conversion. Do NOT use for technical implementation, code review, or software architecture.
When the user wants to price an AI product, choose a charge metric, design pricing tiers, or optimize margins. Also use when the user mentions 'AI pricing,' 'usage-based pricing,' 'consumption pricing,' 'outcome pricing,' 'BYOK,' 'bring your own key,' 'per-seat pricing,' 'pricing tiers,' 'AI margins,' 'cost per token,' or 'pricing model.' This skill covers pricing strategy, packaging, and margin management for AI-native products. Do NOT use for technical implementation, code review, or software architecture.
When the user wants to deploy AI sales development reps, automate sales qualification, build signal-to-action routing, or design AI agent architecture for sales. Also use when the user mentions 'AI SDR,' 'AI sales agent,' 'automated qualification,' 'signal routing,' 'sales automation,' '11x,' 'Artisan,' 'AiSDR,' 'AI BDR,' or 'autonomous sales.' This skill covers AI SDR deployment, qualification automation, and agent architecture for sales development. Do NOT use for technical implementation, code review, or software architecture.
When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture.
Expert AWS Cloud Advisor for architecture design, security review, and implementation guidance. Leverages AWS MCP tools for accurate, documentation-backed answers. Use when user asks about AWS architecture, security, service selection, migrations, troubleshooting, or learning AWS. Triggers on AWS, Lambda, S3, EC2, ECS, EKS, DynamoDB, RDS, CloudFormation, CDK, Terraform, Serverless, SAM, IAM, VPC, API Gateway, or any AWS service. Do NOT use for non-AWS cloud providers or general infrastructure without AWS context.
Apply modern web development best practices for security, compatibility, and code quality. Use when asked to "apply best practices", "security audit", "modernize code", "code quality review", or "check for vulnerabilities". Do NOT use for accessibility (use web-accessibility), SEO (use seo), performance (use core-web-vitals), or comprehensive multi-area audits (use web-quality-audit).
Browser debugging, performance profiling, and automation via Chrome DevTools MCP. Use when user says "debug this page", "take a screenshot", "check network requests", "profile performance", "inspect console errors", or "analyze page load". Do NOT use for full E2E test suites (use playwright-skill) or non-browser debugging.