Agent skill

AI SEO

by borghei in borghei/Claude-Skills

Optimize content to rank in AI search engines (AI Overviews, Perplexity, ChatGPT) via generative engine optimization (GEO), citability audits, and schema markup.

MITAuto-check passedMarketing & SEO

Install AI SEO

skills CLI
$ npx skills add borghei/Claude-Skills --skill ai-seo -a claude-code

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

GitHub CLI
$ gh skill install borghei/Claude-Skills ai-seo --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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing/ai-seo .claude/skills/ai-seo && 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
ai-seo
GitHub stars
886
Token cost
~7.3k tokens
SKILL.md length
3,354 words
Files
4 (incl. scripts)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Optimize content to rank in AI search engines (AI Overviews, Perplexity, ChatGPT) via generative engine optimization (GEO), citability audits, and schema markup.

  • Works in 5 steps: Check robots.txt for AI bot access — the… → Test top 10 target queries on… → Document which queries cite you, which… → …
  • Optimizing for AI search
  • SKILL.md covers Table of Contents, Keywords, Clarify First and Quick Start, plus 6 more sections
  • Runs Python scripts from its folder; calls python; reaches schema.org

What it does

AI SEO is an agent skill from borghei/Claude-Skills. Optimize content to rank in AI search engines (AI Overviews, Perplexity, ChatGPT) via generative engine optimization (GEO), citability audits, and schema markup. Use when optimizing for AI search, generative search, or LLM visibility.

Its SKILL.md is about 7.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/content_scorer.py`, `scripts/keyword_analyzer.py` and `scripts/serp_simulator.py`).

It sits in Marketing & SEO, covering AI search optimization. It works with OpenAI and Perplexity. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Optimizing for AI search
  • Generative search

Example prompts

  • “/ai-seo”

Requirements

  • Python 3

Workflow steps

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

  1. Check robots.txt for AI bot access — the search/retrieval crawlers first (OAI-SearchBot, Claude-SearchBot, PerplexityBot, Googlebot), then…
  2. Test top 10 target queries on Perplexity, ChatGPT, and Google AI Overviews
  3. Document which queries cite you, which cite competitors, and what content format wins
  4. Score key pages against the Extractability Checklist
  5. Prioritize pages with highest gap between search volume and current AI citation presence

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. 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 3 files in scripts/ (Python), 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

    Hosts in commands or code, which the agent is likely to contact:

    • schema.org

    Also links to:

    • developers.google.com
    • support.google.com
    • developers.openai.com
    • support.claude.com
    • docs.perplexity.ai

    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

AI SEO loads about 7.3k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 3,354 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 3,354 words, ~7,258 tokens.

Download SKILL.mdSave it as .claude/skills/ai-seo/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
ai-seo
description
Optimize content to rank in AI search engines (AI Overviews, Perplexity, ChatGPT) via generative engine optimization (GEO), citability audits, and schema markup. Use when optimizing for AI search, generative search, or LLM visibility.
license
MIT
metadata.version
1.0.0
metadata.author
borghei
metadata.category
marketing
metadata.domain
seo
metadata.updated
2026-09-21

AI SEO

Generative engine optimization (GEO) for getting cited by AI search platforms — not just ranked in traditional results.


Table of Contents


Keywords

AI SEO, generative engine optimization, GEO, AI overviews, Google SGE, ChatGPT citations, Perplexity SEO, Claude citations, AI search optimization, semantic search, entity optimization, LLM visibility, AI-generated answers, structured data, schema markup, content extractability, AI citability, GPTBot, PerplexityBot, ClaudeBot, answer engine optimization


Clarify First

Before optimizing, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Target queries — the questions you want to be cited for (drives which pages to optimize and the extractable blocks to add)
  • Target AI platform(s) — Perplexity / ChatGPT / Google AI Overviews / Claude (crawling, indexing, and citation behavior differ per platform)
  • Brand/entity name — exact wording to track (drives citation testing and entity optimization)
  • The page/content to optimize — the URL or draft being restructured (drives extractability scoring + schema selection)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

Run an AI Visibility Audit
  1. Check robots.txt for AI bot access — the search/retrieval crawlers first (OAI-SearchBot, Claude-SearchBot, PerplexityBot, Googlebot), then the training crawlers (GPTBot, ClaudeBot, Google-Extended)
  2. Test top 10 target queries on Perplexity, ChatGPT, and Google AI Overviews
  3. Document which queries cite you, which cite competitors, and what content format wins
  4. Score key pages against the Extractability Checklist
  5. Prioritize pages with highest gap between search volume and current AI citation presence
Optimize a Page for AI Citation
  1. Add a clear definition block in the first 200 words for informational queries
  2. Structure content with self-contained H2 sections that can be extracted independently
  3. Add numbered steps for process queries, comparison tables for "X vs Y" queries
  4. Replace all vague claims with attributed statistics ("According to [Source], [Year]")
  5. Implement schema that matches the page type (Article, Product, Organization, BreadcrumbList) — for accurate entity understanding, not as an AI-citation shortcut (Google states no special schema is needed for AI features)
  6. Verify AI bots are allowed in robots.txt

How AI Search Differs from Traditional SEO

The Fundamental Shift

Traditional SEO gets your page ranked. AI SEO gets your content cited. These are different optimization targets.

DimensionTraditional SEOAI SEO
GoalRank on page 1Get cited in AI-generated answers
Success metricClick-through rateCitation frequency
Content priorityKeyword densityAnswer extractability
Authority signalBacklinks + domain authorityBacklinks + answer quality + attribution
User interactionUser clicks your linkAI extracts your answer; user may never visit
Content formatLong-form comprehensiveSelf-contained extractable blocks
Optimization unitThe pageThe paragraph or section
What Carries Over from Traditional SEO
  • Domain authority still matters. AI systems prefer credible sources.
  • Backlinks still signal trust and expertise.
  • Technical SEO fundamentals (page speed, mobile-friendly, clean HTML) still apply.
  • Quality content with original insights still wins.
What Changes
  • Keyword density matters less than answer clarity and directness
  • Page-level optimization expands to section-level and paragraph-level optimization
  • Internal linking serves discoverability for AI crawlers, not just PageRank flow
  • Structured data helps machines disambiguate entities and page type, but it is not a gate: Google states there is no special schema.org markup required to appear in AI Overviews or AI Mode (as of September 2026)

The Three Pillars of AI Citability

Pillar 1: Structure (Extractable)

AI systems pull content in chunks. They find the paragraph, list, or definition that directly answers a query and extract it. Your content must be structured so answers are self-contained.

Extractability requirements:

  • Definition blocks for "what is X" queries — tight, 1-2 sentence definitions in the first 200 words
  • Numbered steps for "how to do X" queries — verb-first, self-contained steps
  • Comparison tables for "X vs Y" queries — clean table format with headers
  • FAQ blocks for question-based queries — explicit Q&A pairs
  • Statistics with full attribution for data-oriented queries

Anti-patterns that kill extractability:

  • Burying the answer in paragraph 8 of a 4,000-word essay
  • Requiring context from previous sections to understand any individual section
  • Using narrative prose for comparisons that should be tables
  • Placing key definitions only in the conclusion
Pillar 2: Authority (Citable)

AI systems do not just extract the most relevant answer — they extract the most credible one.

Authority signals in the AI era:

  • Domain authority — High-DA domains get preferential citation
  • Author attribution — Named authors with credentials outperform anonymous pages
  • Citation chains — Your content cites credible sources, making you credible in turn
  • Recency — AI systems prefer current information for time-sensitive queries
  • Original data — Proprietary research, surveys, and studies get cited more because AI cannot find this data elsewhere
  • Consistent entity presence — Your brand appears across authoritative sources as an entity
Pillar 3: Presence (Discoverable)

AI systems must be able to find and index your content.

Technical requirements:

  • AI crawlers allowed in robots.txt
  • Fast page load and clean HTML
  • No JavaScript-only rendering for important content
  • Schema markup for content type classification
  • Proper canonical signals
  • HTTPS with valid certificates

Core Workflows

Workflow 1: AI Visibility Audit

Step 1: Bot Access Verification

Check robots.txt for AI crawler permissions:

# Search / retrieval crawlers — blocking these removes you from that platform's AI answers:
Googlebot         # Google Search, incl. AI Overviews and AI Mode
OAI-SearchBot     # ChatGPT search
Claude-SearchBot  # Claude search
PerplexityBot     # Perplexity search
# Training crawlers — blocking these does NOT remove you from AI search answers:
GPTBot            # OpenAI model training
ClaudeBot         # Anthropic model training
Google-Extended   # Gemini training + grounding (not AI Overviews / AI Mode)
Applebot-Extended # Apple Intelligence training

If a search/retrieval crawler is blocked, that is the single highest priority fix — zero visibility on that platform until resolved. A blocked training crawler is a policy choice, not a visibility bug. See Bot Access Configuration for the full matrix.

Step 2: Citation Testing

Test top 10 target queries on each platform:

PlatformHow to TestWhat to Record
PerplexitySearch at perplexity.ai, check Sources panelCited? Which competitors cited? Content format winning?
ChatGPTWeb browsing enabled, check citationsSame
Google AI OverviewsGoogle query, check AI Overview panelSame
Microsoft CopilotSearch at copilot.microsoft.com, check source cardsSame
ClaudeWeb search enabled queriesSame

Step 3: Content Extractability Scoring

Score each key page (0-7):

  • Clear definition of core concept in first 200 words
  • Numbered lists or step-by-step sections for process queries
  • FAQ section with direct Q&A pairs
  • Statistics cited with source name and year
  • Comparisons in table format (not narrative)
  • H1 phrased as an answer or direct statement
  • Valid schema markup matching the page type (Article, Product, Organization, BreadcrumbList)

Interpretation: 0-3 = needs major restructuring. 4-5 = good baseline. 6-7 = strong.

Step 4: Competitive Citation Analysis

For each target query, document:

  • Who is currently being cited (top 3 sources per platform)
  • What content format wins (definition, list, table, quote)
  • What your content lacks that cited competitors provide
  • Where you have unique data or expertise competitors lack
Workflow 2: Page Optimization for AI Citation

Step 1: Lead with the Answer

The first paragraph must contain the core answer to the target query. No preamble, no context-setting, no "In today's landscape..." openers.

Step 2: Structure Self-Contained Sections

Every H2 section must be answerable as a standalone excerpt:

  • Each section opens with its main point
  • Each section contains its own evidence
  • No section requires reading previous sections to be understood
  • Each section could be quoted out of context and still make sense

Step 3: Add Extractable Content Blocks

Insert 2-3 of these per key page:

  • Definition block (first 200 words)
  • Numbered how-to steps (5-10 max, verb-first)
  • Comparison table (clean headers, structured data)
  • FAQ pairs (question matches natural language query)
  • Attributed statistics ("According to [Source] ([Year]), X% of...")
  • Expert quote block ("[Name], [Role at Organization]: '[quote]'")

Step 4: Replace Vague with Specific

Find and replace every vague claim:

  • "Many companies" → name the companies or cite the count
  • "Studies show" → name the study, organization, and year
  • "Significantly improved" → state the percentage improvement
  • "Leading brands" → name at least one
  • "Experts say" → name the expert with credentials

Step 5: Add Schema Markup

Implement JSON-LD in the page head:

Content TypeSchemaImpact (as of September 2026)
Articles and postsArticleMedium — Article rich result + clear author/date signals
Product pagesProduct (+ Review snippet)Medium — Product rich results; product comparison queries
Company pagesOrganizationMedium — entity authority, logo/knowledge panel signals
All pagesBreadcrumbListLow-Medium — Breadcrumb rich result, site hierarchy
Author pagesPerson / ProfilePageLow-Medium — author credibility signal
FAQ sectionsFAQPageLow — FAQ rich results removed from Google Search (May 2026); valid vocabulary, no Google search feature
Step-by-step guidesHowToLow — HowTo rich results removed from Google Search (2023); no Google search feature

The visible on-page structure (Q&A headings, numbered steps) is what AI systems extract. Google states no special schema is required for AI features — do not sell FAQPage/HowTo markup as an AI-citation lever.

Workflow 3: Entity Optimization

Step 1: Define Your Entity

Ensure your brand exists as a recognized entity across the web:

  • Wikipedia or Wikidata presence
  • Google Knowledge Panel
  • Consistent NAP (name, address, phone) across citations
  • Structured About page with Organization schema

Step 2: Build Entity Associations

Connect your entity to relevant topics:

  • Publish original research on topics you want to be cited for
  • Get mentioned (with links) on authoritative sites in your domain
  • Contribute expert quotes to industry publications
  • Maintain active presence on platforms AI systems index

Step 3: Strengthen the Citation Chain

Create a network of credible references:

  • Your content cites authoritative sources
  • Authoritative sources cite your content
  • Your author pages link to credentials and publications
  • Your brand appears in industry roundups and comparisons

Content Patterns That Get Cited

Pattern 1: Definition Block
markdown
**[Term]** is [concise definition in 1-2 sentences]. [One sentence of context
explaining why it matters or how it differs from related concepts].

Place within the first 200 words. No hedging, no preamble.

Pattern 2: Numbered Steps

Requirements for AI extraction:

  • Steps are numbered (not bulleted)
  • Each step starts with an action verb
  • Each step is self-contained (could be quoted alone)
  • 5-10 steps maximum (AI truncates longer lists)
  • Each step has a brief explanation (1-2 sentences)
Pattern 3: Comparison Table

Two-column or multi-column tables with clean headers:

markdown
| Dimension | Option A | Option B |
|-----------|----------|----------|
| Price | $X/mo | $Y/mo |
| Key Feature | Description | Description |
| Best For | Use case | Use case |
Pattern 4: FAQ Block

Explicit Q&A pairs. Questions should match natural language queries:

markdown
### What is [topic]?
[Direct answer in 1-2 sentences.]

### How does [topic] work?
[Step-by-step explanation.]

The visible Q&A structure is what matters for extraction. FAQPage markup is optional — Google no longer shows FAQ rich results (removed May 2026).

Pattern 5: Attributed Statistics
markdown
According to [Source Name] ([Year]), X% of [population] [finding].

Complete attribution is critical. Unattributed statistics get deprioritized because AI cannot verify the source.

Pattern 6: Expert Quote Block
markdown
"[Quote]" — [Name], [Role] at [Organization]

Named experts with credentials produce citable units AI systems pick up.


Schema Markup for AI Discovery

Priority Implementations

Google states that no special schema.org markup is needed to appear in AI Overviews or AI Mode (AI features and your website). Prioritize schema that still produces Google rich results or clarifies entities (Article, Product, Organization, BreadcrumbList); treat FAQPage and HowTo as optional vocabulary.

FAQPage Schema (optional — FAQ rich results removed from Google Search in May 2026):

json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is [topic]?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "[Direct answer]"
      }
    }
  ]
}

HowTo Schema (optional — HowTo rich results removed from Google Search in 2023):

json
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to [do thing]",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Step name",
      "text": "Step description"
    }
  ]
}

Article Schema (still eligible for rich results; establishes author and date signals):

json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Title",
  "author": {
    "@type": "Person",
    "name": "Author Name",
    "url": "https://author-page"
  },
  "datePublished": "2026-01-15",
  "dateModified": "2026-03-01"
}

Validate all schema at schema.org/validator before deployment.


Bot Access Configuration

AI Crawler Matrix (as of September 2026)

The major AI vendors now split crawling by purpose, so search visibility and training can be controlled separately.

VendorUser agentPurposeBlocking it meansHonors robots.txt
OpenAIGPTBotModel trainingContent excluded from future trainingYes
OpenAIOAI-SearchBotChatGPT search indexNot surfaced/cited in ChatGPT search answersYes
OpenAIChatGPT-UserFetches a page when a user's request needs itUser-initiated; OpenAI says robots.txt rules "may not apply"Not guaranteed
AnthropicClaudeBotModel trainingFuture content excluded from trainingYes
AnthropicClaude-SearchBotClaude search indexReduced visibility in Claude search answersYes
AnthropicClaude-UserFetches a page when a Claude user asksClaude cannot retrieve your page for usersYes
PerplexityPerplexityBotPerplexity search indexNot surfaced/linked in Perplexity answersYes
PerplexityPerplexity-UserFetches a page for a user's questionPerplexity says this fetcher generally ignores robots.txtNo
GoogleGooglebotGoogle Search, including AI Overviews and AI ModeRemoves you from Google Search entirelyYes
GoogleGoogle-Extended (robots.txt token, not a separate crawler)Gemini training and grounding in some Google systems; also limits training of the models behind Search generative AI featuresDoes not remove you from Google Search, ranking, AI Overviews or AI ModeYes

Sources: OpenAI crawlers, Anthropic crawlers, Perplexity crawlers, Google common crawlers.

Google AI Overviews / AI Mode opt-out: Google-Extended does not control appearance in them — they are served from Googlebot's index. Your options (as of September 2026):

  • Search Console "Search generative AI" control (Settings > Search generative AI; rolled out to all sites August 31, 2026) — excludes the site's links and content from AI Overviews, AI Mode, and generative AI features in Discover, without affecting ranking or inclusion in the rest of Search. Takes effect within a few days (help).
  • Page-level snippet controls — nosnippet, data-nosnippet, max-snippet limit what can be shown, but also limit how the page appears in regular Search results.
  • noindex — removes the page from Google Search entirely.
Show full SKILL.md (1,248 more words)Show less
# Allow AI search / retrieval crawlers (visibility)
User-agent: OAI-SearchBot
Allow: /

User-agent: Claude-SearchBot
Allow: /

User-agent: Claude-User
Allow: /

User-agent: PerplexityBot
Allow: /

# Training crawlers — Allow or Disallow per your content policy;
# this choice does not affect AI search citation
User-agent: GPTBot
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: Google-Extended
Allow: /

User-agent: Applebot-Extended
Allow: /
Training vs. Citation Access

Allowing AI citation while blocking training is enforceable for OpenAI, Anthropic, and Perplexity: allow the search crawler (OAI-SearchBot, Claude-SearchBot, PerplexityBot) and disallow the training crawler (GPTBot, ClaudeBot). Blocking one does not block the other.

Google works differently: Google-Extended limits training and Gemini grounding but not appearance in AI Overviews or AI Mode. To keep regular Search visibility but leave AI Overviews / AI Mode, use the Search Console Search generative AI control (as of September 2026); snippet controls and noindex also work but cost regular Search presentation.

Recommendation: Always allow the search/retrieval crawlers if you want AI citation visibility; decide on training crawlers as a separate content-licensing policy.


Monitoring and Tracking

Weekly Citation Tracking (20 minutes/week)

Test top 10 target queries on Perplexity and ChatGPT:

  • Were you cited? (yes/no)
  • Citation rank (1st source, 2nd, 3rd)
  • What text was used from your content?
  • Any new competitors appearing?
Google Search Console for AI Overviews and AI Mode

There is no "AI Overviews" search-type filter in the Performance report. Clicks and impressions from AI Overviews and AI Mode are counted inside the standard Web search type, blended with regular results (AI features and your website).

As of September 2026, Search Console also has a dedicated Generative AI performance report (announced June 2026, rolled out to all sites by August 31, 2026; sites need enough impressions to see data) (announcement, help):

  • Impressions only — no click data — for links to your site shown in AI Overviews and AI Mode
  • Group by page, country, device, and date to see which pages get surfaced most
  • Standard Performance-report limits apply (1,000-row cap, preliminary recent data)

For clicks, use the Web search type in the Performance report plus landing-page analytics; AI-feature clicks cannot be isolated there.

Monthly Monitoring Checklist
SignalWhat to CheckTool
Perplexity citationsTop 10 queriesManual testing
ChatGPT citationsTop 10 queriesManual testing
Google AI Overviews / AI ModeImpressions (Generative AI report); clicks only blended into Web search typeGoogle Search Console
Copilot citationsTop 5 queriesManual testing
AI bot crawl activityCrawl frequency and pagesServer logs / Cloudflare
Competitor citationsWho is getting cited for your queriesManual testing
Content freshnessDate signals on key pagesContent audit
When Citations Drop

Diagnostic checklist when you lose a citation:

  1. Did robots.txt change? (Check for accidental AI bot blocks)
  2. Did a competitor publish more extractable content?
  3. Did your page structure change? (Restructuring can break citation patterns)
  4. Did your domain authority drop? (Check backlink profile)
  5. Did the query intent shift? (AI systems may reinterpret the query)

Best Practices

  1. Optimize at the section level, not just the page level — AI extracts paragraphs and sections, not entire pages. Every H2 block should be independently citable.

  2. Lead with the answer, always — The first 200 words determine whether AI systems find your content useful. Put the answer there.

  3. Attribute everything — Unattributed statistics, unnamed experts, and sourceless claims reduce your citability. Name names.

  4. Update quarterly — AI systems prefer recent content. Update publish dates and refresh data points every 90 days.

  5. Build entity presence — The stronger your brand's entity recognition across the web, the more AI systems trust and cite you.

  6. Do not choose between traditional SEO and AI SEO — They are complementary. Many optimization signals overlap. Run both.

  7. Test on multiple platforms — A page cited on Perplexity may not be cited on ChatGPT. Optimize for the platforms your audience uses.

  8. Monitor competitors monthly — Track who gets cited for your target queries and study what content patterns they use.

  9. Avoid JavaScript-rendered content for key answers — AI crawlers may not execute JavaScript. Ensure important content is in the initial HTML.

  10. Implement schema accurately, not as a hack — Article, Product, Organization, and BreadcrumbList markup that matches visible content helps entity understanding. Google says no special schema is required for AI features, and FAQ/HowTo rich results no longer display.


Integration Points

  • SEO Specialist — Use for traditional search ranking optimization. Run AI SEO and traditional SEO in parallel.
  • Content Production — Use to create the underlying content before optimizing for AI citation.
  • Content Humanizer — Use after writing. AI-sounding content performs worse in AI citations — AI systems prefer credible, human-sounding writing.
  • Content Strategy — Use when deciding which topics and queries to target for AI visibility.
  • Marketing Analytics — Use campaign analytics tools to track the business impact of AI citation traffic.

Troubleshooting

ProblemLikely CauseFix
Content not cited despite high DAPoor extractability — answers buried in proseRestructure with definition blocks, numbered steps, and FAQ pairs in first 200 words
Cited on Perplexity but not ChatGPTDifferent crawling and indexing pipelines per platformVerify bot access for all AI crawlers; test rendering without JavaScript
AI Overview shows competitor insteadCompetitor has more extractable, better-attributed contentAudit competitor's cited content format and match or exceed specificity
Citation dropped after site updatePage restructure broke the extraction pattern AI was usingCompare old vs new page structure; restore extractable blocks
OAI-SearchBot / PerplexityBot blocked in robots.txt unknowinglyCMS update or security plugin overwrote robots.txtAudit robots.txt after every CMS or plugin update; set up monitoring
Schema markup present but no rich resultsMissing required fields or content-markup mismatchValidate with Google Rich Results Test; ensure schema matches visible page content
AI cites your data but not your brandMissing entity signals — no Organization schema or sameAs linksImplement Organization schema with sameAs to Wikidata, LinkedIn, and social profiles

Success Criteria

  • AI citation rate: Achieve citation in 30%+ of target queries across Perplexity, ChatGPT, and Google AI Overviews within 90 days of optimization
  • Extractability score: Score 6-7 out of 7 on the Content Extractability Scoring checklist for all key pages
  • Bot access: Zero AI search/retrieval crawlers blocked in robots.txt (training crawlers per documented policy) — verified monthly with automated monitoring
  • Entity recognition: Brand appears in Google Knowledge Panel and is recognized as an entity on Wikidata
  • Schema coverage: 100% of content pages have JSON-LD schema matching the page type (e.g., Article, Product, Organization, BreadcrumbList) validated without errors
  • Freshness cadence: All key pages updated within the last 90 days with current dateModified signals
  • CTR from AI Overviews: Track organic CTR separately for queries where AI Overviews appear and hold it at or above your own pre-optimization baseline for those queries in Search Console

Scope & Limitations

In scope:

  • Optimizing content structure for AI extraction and citation
  • Bot access configuration and monitoring
  • Schema markup implementation for AI discoverability
  • Entity optimization and Knowledge Graph presence
  • Citation tracking across AI search platforms
  • Content pattern design (definitions, steps, tables, FAQs)

Out of scope:

  • Traditional organic ranking optimization (use SEO Specialist)
  • Content creation from scratch (use Content Production)
  • Paid search or paid AI placement strategies
  • AI model training data licensing or opt-out negotiations
  • Platform-specific API integrations for automated tracking
  • Social media optimization for AI-adjacent platforms

Known limitations:

  • AI citation tracking is largely manual — no standardized API exists across platforms
  • Citation algorithms are opaque and change frequently without notice
  • Blocking AI training while allowing citation works per vendor via separate user agents (OpenAI, Anthropic, Perplexity); Google AI Overviews / AI Mode use Googlebot, so appearance there is controlled in Search Console, not robots.txt
  • User-initiated fetchers (ChatGPT-User, Perplexity-User) may not honor robots.txt
  • AI summaries are reported to reduce clicks on traditional results (Pew Research Center, July 2025: users clicked a traditional result in 8% of visits with an AI summary vs. 15% without; Google reports overall organic click volume as relatively stable), and this cannot be fully mitigated

Scripts

bash
# Analyze content for AI citability signals
python scripts/content_scorer.py page.html --json

# Simulate how content might appear in AI search results
python scripts/serp_simulator.py --query "what is cloud cost optimization" --content page.md

# Analyze keyword opportunities for AI search visibility
python scripts/keyword_analyzer.py --keywords keywords.csv --json

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in marketing/ai-seo of borghei/Claude-Skills.

  • SKILL.md
  • scripts/content_scorer.py
  • scripts/keyword_analyzer.py
  • scripts/serp_simulator.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

AI SEO 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.

AI SEO compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI SEO this skillborghei/Claude-Skills886—~7.3kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
Fire Your SEO Agencyleopard627/fire-your-seo-agency708—~1.1kAutomated safety check: PassMIT
Marketing OsYuzzyuk/marketing-os538—~2.5kAutomated safety check: PassMIT

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated today
    Marketing & SEOAuto-check: notes
  • Fire Your SEO Agency

    leopard627/fire-your-seo-agency

    SEO·AEO·GEO·LLMO·NEO(네이버) 다섯 레인을 진단하고 직접 구현하며, 인용되는 콘텐츠를 계속 생산하는 서브 블로그·콘텐츠 운영 파이프라인까지 세팅하는 스킬.

    708 GitHub stars~1.1k tokensUpdated 13 days ago
    Marketing & SEOAuto-check passed
  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    538 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • AI Visibility

    Ryze-AI-Adgent/open-seo-mcp-skills

    Measure real AI-engine visibility — traffic from ChatGPT, Perplexity, Claude, Gemini and which pages they cite — from actual GA4 referral data, not prompt sampling.

    4.6k GitHub stars~611 tokensUpdated 15 days ago
    Marketing & SEOAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about AI SEO

What does AI SEO do?

Optimize content to rank in AI search engines (AI Overviews, Perplexity, ChatGPT) via generative engine optimization (GEO), citability audits, and schema markup. AI SEO is an agent skill from borghei/Claude-Skills. Optimize content to rank in AI search engines (AI Overviews, Perplexity, ChatGPT) via generative engine optimization (GEO), citability audits, and schema markup.

When should I use AI SEO?

AI SEO fits situations like: optimizing for AI search; generative search.

How do I install AI SEO in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill ai-seo -a claude-code`. Or copy the skill folder (marketing/ai-seo in borghei/Claude-Skills) into .claude/skills/ai-seo in your project. Claude Code loads it when a task matches its description.

How do I install AI SEO in Codex?

Run `npx skills add borghei/Claude-Skills --skill ai-seo -a codex`. Or copy the skill folder (marketing/ai-seo in borghei/Claude-Skills) into .agents/skills/ai-seo in your project. Codex loads it when a task matches its description.

Can I use AI SEO 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 borghei/Claude-Skills --skill ai-seo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ai-seo, .gemini/skills/ai-seo, .github/skills/ai-seo and .opencode/skills/ai-seo in your project.

What does AI SEO need to run?

Going by SKILL.md and its folder, AI SEO needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does AI SEO access the network?

SKILL.md names 6 domains. In commands or code: schema.org; the agent is likely to contact it when it follows the instructions. As links in the text: developers.google.com, support.google.com, developers.openai.com, support.claude.com and docs.perplexity.ai. This is read from the text; nothing was executed.

Is AI SEO safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 AI SEO use?

AI SEO is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does AI SEO use?

About 7.3k tokens (SKILL.md is roughly 29k 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 AI SEO?

Skills that share tags, products or a category with AI SEO: Geo Fundamentals (wasp-lang/wasp, 19k stars), SEO Geo (ReScienceLab/opc-skills, 1.8k stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars) and Fire Your SEO Agency (leopard627/fire-your-seo-agency, 708 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI SEO?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

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