seo-aeo-geo — Claude Code skill: optimize for AI search
A skill for tuning content and site structure for AI search: citations in model answers, llms.txt, extraction-friendly markup.
npx skills add rampstackco/claude-skills --skill seo-aeo-geo -a claude-codeWhat seo-aeo-geo does
The skill splits AI search visibility into five layers. First comes extractable structure: a short direct answer at the top of a section, question-shaped headings, tables and numbered steps. Then citation worthiness — original data, specific numbers, a credentialed author, publish and update dates. Structured data, AI crawler access and entity signals such as Wikidata and consistent NAP follow.
The workflow is stepwise: audit the site against those layers, list priority queries, check whether the major AI products cite you, work out why you lose to the sources they do cite, then fix pages. There is a separate pass on llms.txt at the site root and on robots.txt with an explicit call on GPTBot, ClaudeBot, Google-Extended and PerplexityBot. Blocking crawlers by default works against you when visibility matters.
This stacks on top of ordinary SEO rather than replacing it — for on-page, technical and keyword work it points you at other skills. One weak spot: content rendered only on the client. Many AI crawlers render less reliably than Googlebot, so that markup has to move server-side.
What it helps with
- build an llms.txt listing the site and its key URLs
- check whether AI search answers cite the site
- rewrite sections so the answer lands in the first lines
- add schema.org types and fill recommended properties
- decide which AI crawlers to allow in robots.txt
Example prompts for the agent
- audit my site against the five AEO layers and tell me what's missing
- build an llms.txt for the blog and list the key pages
- why doesn't AI search cite my pricing article?
How to install seo-aeo-geo
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-aeo-geo -a claude-code2Manually: put the files in place
~/.claude/skills/seo-aeo-geo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-aeo-geo/
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-aeo-geo -a codex2Manually: put the files in place
.agents/skills/seo-aeo-geo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-aeo-geo -a cursor2Manually: put the files in place
.cursor/skills/seo-aeo-geo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rampstackco/claude-skills seo-aeo-geo2Manually: put the files in place
.github/skills/seo-aeo-geo/SKILL.md1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-aeo-geo -a gemini-cli2Platform CLI
gemini skills install https://github.com/rampstackco/claude-skills --path skills/seo-aeo-geoManually: put the files in place
.devin/skills/seo-aeo-geo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-aeo-geo -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about seo-aeo-geo
How do I install seo-aeo-geo in Claude?
Run npx skills add rampstackco/claude-skills --skill seo-aeo-geo -a claude-code. The skill lands in ~/.claude/skills/seo-aeo-geo/SKILL.md.
What does seo-aeo-geo do?
It helps shape a site for AI search: extractable text structure, citation signals, schema.org, llms.txt and crawler access.
How is it different from a regular SEO skill?
It sits on top of fundamental SEO. On-page, technical and keyword work is handed off to other skills; this one covers AI search.
Source text
SKILL.md · MIT
--- name: seo-aeo-geo description: "Optimize content and site structure for AI-driven search experiences including AI overviews, large language model citations, generative answer engines, and AI assistants. Use this skill whenever the user wants to optimize for AI search, get cited by language models, appear in AI overviews, build llms.txt, structure content for AI extraction, or future-proof their SEO for the shift from blue links to AI answers. Triggers on AEO, GEO, AI search, AI SEO, AI overview, generative search, LLM optimization, llms.txt, AI citation, ChatGPT search, Perplexity, Gemini, Claude search, AI assistant optimization, answer engine. Also triggers when the user expresses concern about AI eating their organic traffic or wants to understand how to remain visible as search shifts." category: seo-foundation catalog_summary: "AI search optimization, llms.txt, extraction-friendly content" display_order: 7 --- # AEO and GEO Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO). Make content discoverable, extractable, and citable by AI search experiences. This skill encodes principles. AI search products evolve fast. The principles age slower than the products. --- ## When to use - Optimizing content for AI overviews and generative answer engines - Building or updating llms.txt - Structuring content so AI assistants can extract and cite it correctly - Future-proofing a site as search shifts from blue links to AI answers - Auditing whether existing content is AI-friendly - Adding signals that help AI assistants identify the site as a trustworthy source ## When NOT to use - Traditional on-page or technical SEO (use `seo-onpage` or `seo-technical`) - Keyword research (use `seo-keyword`) - Off-page authority and link building (use `seo-offpage`) This skill stacks on top of those. Strong AEO/GEO requires strong fundamental SEO underneath. --- ## Required inputs - The site or page to optimize - The topic area or query types AI should cite the site for - Access to inspect rendered HTML and structured data --- ## The framework: 5 layers AI search visibility comes from five stacked layers. Each layer compounds. ### 1. Extractable content structure AI systems extract facts and pull citations from content. Make extraction easy. - **Direct answers.** Open major sections with a definitive 1 to 3 sentence answer to the question that section addresses. AI extracts the first answer it sees. - **Question-headers.** Use H2s and H3s phrased as questions when natural. Mirrors how people prompt AI. - **Atomic facts.** When stating a fact, state it once, clearly, with the supporting context next to it. AI struggles when claims are spread across paragraphs. - **Tables and lists.** AI parses these reliably. Use them for comparisons, specs, steps, and data. - **Definitions early.** When introducing a concept, define it inline. Do not assume the reader (or AI) saw a definition three pages ago. - **Numbered steps.** For procedural content, number every step. Avoid prose disguised as instructions. ### 2. Citation worthiness AI cites sources it considers authoritative. Earn that consideration. - **Original data.** Surveys, studies, proprietary research, internal benchmarks. AI prefers primary sources over restatements. - **Specific numbers.** "Roughly 40 percent" beats "many." Specific stats with sources beat round-number generalizations. - **Named experts.** Author bios with credentials, links to professional profiles, schema-marked-up Person entities. - **Date stamps.** Publication date AND last-updated date, both visible AND in schema. AI heavily weights recency for time-sensitive queries. - **Methodology disclosure.** When stating a finding, briefly note how it was reached. AI rewards transparency. - **Citations of other sources.** Linking to authoritative sources you used builds reciprocal credibility. ### 3. Structured data depth Schema is how you speak machine-readable language. AI assistants parse it heavily. - **Schema.org types** appropriate to content (Article, FAQPage, HowTo, Recipe, Product, Organization, Person, LocalBusiness, etc.) - **Required AND recommended properties** filled in (most sites only fill required, leaving signal on the table) - **Person schema** for authors, with `sameAs` links to verifiable profiles - **Organization schema** on the homepage with logo, contact, social links - **FAQPage schema** for content with genuine question-answer pairs - **HowTo schema** for procedural content - **BreadcrumbList schema** site-wide - Validates in Schema.org Validator AND Rich Results Test (some properties differ) ### 4. AI-readable accessibility Beyond traditional SEO, AI tools need access patterns of their own. - **llms.txt at the site root.** A markdown file at `/llms.txt` describing the site's content, key URLs, and what topics the site covers. See [`references/llms-txt-guide.md`](references/llms-txt-guide.md). - **llms-full.txt** (optional) - a complete content dump for AI training and context, if the site permits it. - **robots.txt allowing AI crawlers.** Decide explicitly which AI crawlers to allow (GPTBot, ClaudeBot, Google-Extended, PerplexityBot, etc.) or disallow. Do not block by default if visibility matters. - **Clean HTML semantics.** Semantic tags (`article`, `section`, `nav`, `main`) help AI parse structure. - **Avoid client-side-only rendering for critical content.** Many AI crawlers render less reliably than Googlebot. ### 5. Real-world entity signals AI builds knowledge graphs and prefers entities with multiple consistent signals. - **Wikipedia entry** if the brand or person qualifies for notability (do not force this; it requires genuine notability) - **Wikidata entry** for the entity, with consistent properties - **Consistent NAP** (Name, Address, Phone) across all citations - **Brand mentions across multiple authoritative sources.** AI cross-references entity claims across the open web. - **Social profile schema** linking owned profiles via `sameAs` properties - **Reviews and reputation signals.** Aggregate ratings on Google Business, Trustpilot, industry-specific review sites where applicable --- ## Workflow 1. **Audit current state.** Run the 5-layer framework against the existing site. Score each. 2. **Identify the priority queries.** What questions should AI cite this site for? List 10 to 20. 3. **Test current AI visibility.** Query each of the major AI products (those relevant to the audience) with the priority questions. Note which sources they cite, or state the gap per the data-availability rule. 4. **Identify gaps.** Is the site cited? On which queries? Why does it lose to the cited sources? 5. **Layer-by-layer plan.** - Fix extractable structure on top 20 priority pages - Add citation-worthy signals (original data, expert authorship, methodology) - Deepen schema implementation - Build/update llms.txt - Strengthen entity signals 6. **Implement and re-test.** AI products update frequently. Re-test priority queries quarterly. --- ## Failure patterns - **Treating AEO/GEO as separate from SEO.** Strong fundamental SEO is a prerequisite. AI cites pages, not magic. - **Stuffing FAQ schema on pages that have no genuine FAQs.** Search engines and AI alike penalize manufactured FAQ blocks. - **Hiding key content behind heavy JavaScript.** AI crawlers render less reliably. Server-render or pre-render critical content. - **Optimizing for one AI product only.** Different products use different ranking and citation logic. Optimize for the principles, not for one product's quirks. - **Ignoring entity strength.** Content alone, with no real-world entity signals, will not get cited reliably for branded or expertise-related queries. - **Treating llms.txt as a magic bullet.** It helps, but it is one of many signals. - **Static optimization.** AI products evolve faster than search algorithms historically did. Re-audit at least quarterly. --- ## Output format Default output is a markdown plan at `aeo-geo-strategy.md`. Structure: 1. Current AI visibility audit (which queries cite the site, which do not) 2. 5-layer scorecard 3. Priority queries (the 10 to 20 the site should be cited for) 4. Layer-by-layer remediation plan 5. Implementation roadmap 6. Re-test schedule (quarterly) --- ## If required data is unavailable This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer. --- ## Reference files - [`references/llms-txt-guide.md`](references/llms-txt-guide.md) - How to write a useful llms.txt, with examples. - [`references/extraction-friendly-patterns.md`](references/extraction-friendly-patterns.md) - Content patterns that AI extracts cleanly, with before/after examples.
© rampstackco · MIT · rampstackco/claude-skills