ai-seo

Overview

What the ai-seo skill does

ai-seo is a specialized SEO and content strategy skill focused on AI search, not just classic Google rankings. It helps you make your pages discoverable, extractable, and citable by AI systems including Google AI Overviews, ChatGPT, Perplexity, Claude, Gemini, and Copilot.

Instead of optimizing only for blue links, ai-seo guides you to:

• Audit your current visibility in AI-generated answers
• Improve the way your content is structured so LLMs can cleanly quote it
• Strengthen authority signals that make your site a preferred citation
• Align your content with how different AI platforms pick and rank sources

The skill leans on:

• A structured AI Visibility Audit workflow
• A three-pillar framework: Structure, Authority, Presence
• Practical content patterns for answer engines (AEO) and generative engines (GEO)
• Platform-specific ranking factor guidance across major AI assistants

Who ai-seo is for

ai-seo is a good fit if you are:

• A marketing or SEO lead who wants your brand named in AI answers
• A content strategist planning an AI search visibility roadmap
• A founder or PMM who keeps seeing competitors cited in ChatGPT or Perplexity
• An agency or consultant offering AI SEO / AEO / GEO services

It is not primarily for:

• Deep technical SEO audits (crawl errors, site speed, internal linking) → use seo-audit instead
• Schema.org or structured data implementation details → use schema-markup instead
• Generic keyword research without a focus on AI-driven results

Problems the ai-seo skill solves

Use ai-seo when you need to answer questions like:

• “How do we get our SaaS into ChatGPT and Perplexity recommendations?”
• “Why do AI Overviews never cite our content?”
• “What content patterns help us win AI answer boxes and summaries?”
• “Should we allow or block AI crawlers in robots.txt?”
• “How do different AI platforms decide which sites to cite?”

The skill helps you systematically:

• Check if and where your brand currently appears in AI responses
• Identify gaps in your content structure that stop LLMs from quoting you
• Apply proven AEO and GEO content block patterns to key pages
• Prioritize concrete next steps based on research-backed ranking signals

---

How to Use

Installation and setup

To add ai-seo to your agent environment, install it from the coreyhaines31/marketingskills repository:

npx skills add https://github.com/coreyhaines31/marketingskills --skill ai-seo

After installation:

1. Open the skills/ai-seo/ folder.
2. Start with SKILL.md for the core behavior, scope, and decision logic.
3. Review the references/ and evals/ folders for patterns and examples.

Key files:

• SKILL.md – main definition of the ai-seo skill and workflow
• references/content-patterns.md – reusable AEO and GEO content patterns
• references/platform-ranking-factors.md – how major AI platforms select sources
• evals/evals.json – sample prompts and expected behaviors for validation

Core workflow: from audit to action plan

The ai-seo skill is designed around a step-by-step strategy rather than one-off tips. The high-level flow includes:

1. Gather AI visibility context

Before running deep analysis, the skill looks for broader product and brand context.

If your repo includes a product marketing context file, ai-seo expects it to be read first:

• .agents/product-marketing-context.md (current pattern)
• .claude/product-marketing-context.md (older setups)

If that file is missing or incomplete, the workflow will prompt for essentials such as:

• Your product and category (e.g., “B2B project management SaaS”)
• Priority use cases and target audiences
• Key competitor brands you see cited in AI answers
• Your most important queries or topics

This prevents repetitive questions and keeps AI SEO decisions aligned with your positioning.

2. Run an AI Visibility Audit

Next, ai-seo guides you through an AI visibility check across major platforms, typically covering:

• Google AI Overviews
• ChatGPT
• Perplexity
• Claude
• Gemini
• Copilot

The audit focuses on:

• Whether your brand appears for target queries at all
• How often you are cited compared with competitors
• What types of pages (guides, docs, pricing, comparisons) tend to get quoted

This stage is where you identify zero-visibility gaps and prioritize which queries or pages to address first.

3. Apply the three pillars: Structure, Authority, Presence

ai-seo uses a three-pillar framework that appears throughout the prompts and references:

1. Structure – Make content extractable

   • Use clear headings, tight definitions, and self-contained answer blocks
   • Break complex explanations into step-by-step or FAQ patterns
   • Include well-structured comparisons and pros/cons tables

2. Authority – Make content citable

   • Strengthen E-E-A-T signals with author expertise and credible sources
   • Incorporate statistics, external citations, and clear claims
   • Avoid overly salesy copy in key educational pages that AI systems use as sources

3. Presence – Be where AI looks

   • Ensure your content is indexed in the search backends that each AI platform uses
   • Confirm AI bots are allowed in robots.txt if you want citations
   • Publish formats and topics that each AI assistant prefers to quote

The skill uses these pillars to move from audit findings to a prioritized list of fixes.

4. Use AEO and GEO content patterns

The references/content-patterns.md file gives you ready-made patterns designed for answer engines and generative engines.

From that guide, you get:

• Answer Engine Optimization (AEO) patterns

  • Definition blocks for “What is X?” queries
  • Step-by-step blocks for “How to” queries
  • Comparison table blocks for “[Tool] vs [Tool]” content
  • Pros and cons, FAQ, and listicle blocks for skimmable answers

• Generative Engine Optimization (GEO) patterns

  • Statistic citation blocks
  • Expert quote and authoritative claim blocks
  • Self-contained answer blocks AI can drop directly into responses
  • Evidence-focused “sandwich” structures that mix claims and proof

ai-seo can help you decide which patterns to apply to a given page and how to adapt them to your brand voice.

5. Align with platform-specific ranking factors

Different AI platforms rely on different indices and ranking logic. The references/platform-ranking-factors.md guide (which ai-seo uses for reasoning) explains:

• Shared fundamentals: index inclusion, crawlability, extractability
• How Google AI Overviews layer AI selection on top of traditional SEO signals
• Why citations, statistics, and structured data correlate with better visibility
• How domain authority and topical relevance studies relate to AI citations

The skill uses this knowledge to tailor recommendations, for example:

• Emphasizing E-E-A-T and structured data for Google AI Overviews
• Prioritizing clearly sourced, self-contained passages for LLMs like ChatGPT and Perplexity

6. Produce a prioritized action plan

Using the audit and patterns, ai-seo typically ends by proposing a concise, ranked plan, such as:

• High-impact page rewrites using AEO/GEO patterns
• New content pieces designed to fill visibility gaps on specific queries
• Technical and policy decisions around AI bot access and indexing

You can then assign these tasks to writers, SEOs, or product marketers.

Example ways to prompt the ai-seo skill

Once installed, route queries to ai-seo when you see AI-focused SEO language, for example:

• “We never show up in Google AI Overviews. What should we fix first?”
• “How do I optimize our blog posts so ChatGPT cites us as a source?”
• “Create an AI visibility audit checklist for our fintech SaaS.”
• “Help me redesign this comparison page so Perplexity is more likely to quote it.”

In each case, ai-seo will:

• Look for product marketing context
• Run through the three-pillar framework
• Reference the visibility audit and content pattern guides
• Return a structured, prioritized set of actions

When ai-seo is not a good fit

Consider a different skill if your main need is:

• Technical SEO health checks (crawl budget, sitemaps, 404s) → use seo-audit
• Schema markup planning and validation → use schema-markup
• Pure social media content calendars without AI search goals → use social- or content-focused skills instead

ai-seo is best used when AI-driven search visibility, answer engine optimization, and AI citations are the primary goals.

---

FAQ

How is ai-seo different from traditional SEO tools?

ai-seo focuses specifically on AI search and answer engines. Instead of only trying to improve rankings on classic SERPs, it helps you:

• Audit how often you appear in AI-generated answers
• Structure content so LLMs can easily quote it
• Align with AI-specific ranking factors outlined in the repository’s reference guides

For full technical SEO or site-wide health, you should pair ai-seo with more traditional SEO skills and tools.

How do I install the ai-seo skill?

Install ai-seo from the coreyhaines31/marketingskills repository using:

npx skills add https://github.com/coreyhaines31/marketingskills --skill ai-seo

Then open the skills/ai-seo/ folder and review SKILL.md, followed by the references/ and evals/ directories.

What files should I read first after installing?

For a quick but solid understanding:

1. SKILL.md – explains what ai-seo does and how it should behave.
2. references/content-patterns.md – shows the AEO and GEO content block patterns you can apply right away.
3. references/platform-ranking-factors.md – explains how different AI platforms choose sources.
4. evals/evals.json – contains example prompts and expected outputs to see how the skill should respond.

Can ai-seo tell me whether to block AI crawlers in robots.txt?

Yes. The evals and references include scenarios about AI bot access. The skill considers:

• Your concerns (e.g., content reuse vs. brand visibility)
• Trade-offs between blocking bots and losing citation opportunities
• The importance of crawlability for being cited in AI answers

You can ask ai-seo questions like:

• “Should we block GPTBot and PerplexityBot?”
• “What happens to our AI visibility if we disallow AI crawlers?”

Does ai-seo cover structured data and schema markup?

ai-seo is aware that structured data can support visibility in AI Overviews and answer engines, but it does not specialize in schema implementation. For detailed schema strategy and markup help, use the dedicated schema-markup skill alongside ai-seo.

Is ai-seo suitable for non-SaaS businesses?

ya. While many examples reference SaaS and B2B, the underlying frameworks apply to:

• E‑commerce
• Content publishers
• Service businesses
• Professional and advisory firms

As long as your goal is to appear and be cited in AI answers, ai-seo can be adapted to your domain using your own product marketing context.

How do I know if ai-seo is working?

You can track impact by:

• Repeating your AI visibility audit periodically and logging improvements
• Checking whether your brand appears more often as a cited source for target queries
• Monitoring changes in traffic and assisted conversions from AI-influenced queries (where measurable)

ai-seo itself provides the strategic plan and structured recommendations; measurement happens in your usual analytics and AI platform checks.