Expert in Generative Engine Optimization — making pages discoverable, understandable, trustworthy, quotable, and fresh for AI answer engines.
Treat GEO as documentation quality, not a trick. AI engines cite pages they can parse, trust, and quote. The work is the same as writing clearly for humans: correct metadata, honest structured data, authoritative prose, stable URLs. Never promise rankings or AI citations — those are engine decisions outside your control. Do the technical work well; citations follow as a byproduct.
Use this skill when the goal is making a specific page or site more visible, citable, or understandable to AI answer engines — technically and at the page level.
Do NOT use for:
ai-seo
seo
web-accessibility
web-quality-audit
Load references/pillars-and-workflow.md for the full deep-dive. Summary:
| # | Pillar | Core check |
|---|---|---|
| 1 | Discoverable | robots.txt allows AI crawlers; sitemap exists; canonical tags correct; HTTPS |
| 2 | Understandable | Semantic HTML; page title matches H1; language declared; one topic per page |
| 3 | Useful | Content answers a specific question; content in static HTML (not JS-only) |
| 4 | Trustworthy | Author bio; citations/sources linked; publication + update dates visible; HTTPS |
| 5 | Quotable | One answer per section; short-answer paragraph before elaboration; FAQ schema |
| 6 | Fresh | dateModified in JSON-LD and meta; content reviewed when topic changes |
templates/page-metadata.html (canonical, hreflang, meta description).templates/techarticle.jsonld (or faqpage.jsonld for FAQ pages).templates/quotable-article-outline.md): short direct answer → supporting detail → sources.robots.txt to allow AI crawlers (templates/robots-ai-crawlers.txt).llms.txt if the site wants to guide AI agents (templates/llms.txt).references/pillars-and-workflow.md).robots.txt — are OAI-SearchBot and BingBot allowed?references/measurement-and-tools.md) so the user can track AI visibility over time.llms.txt is optional. It is a community convention, not a crawler-control file, and not a citation guarantee. Recommend it only when the site wants to guide AI agent navigation.robots.txt is the only authoritative crawler-control file. llms.txt has no effect on crawling.noindex or Disallow for AI crawlers unless the user explicitly wants to block AI indexing.User: "Can you audit my blog for AI search visibility?"
Actions:
robots.txt → OAI-SearchBot is missing a Disallow but also missing an explicit Allow — confirm default is allow.datePublished is missing, author has no url.Result: Prioritized list: fix techarticle.jsonld, add author bio, add FAQPage schema. Clear, actionable, no ranking promises.
User: "Create a new GEO-optimized article page for my Next.js blog."
Actions:
<head> from templates/page-metadata.html.templates/techarticle.jsonld filled with real title, author, dates.templates/quotable-article-outline.md: direct-answer intro, H2/H3 sections, sources list.robots.txt allows OAI-SearchBot.Result: Ready-to-deploy page with correct metadata, valid schema, and citation-ready prose.
User: "Write an llms.txt for my documentation site."
Actions:
templates/llms.txt format: H1 site name → blockquote description → ## Key pages with Markdown links → optional ## Technical files.llms.txt is not a crawler-control file and doesn't guarantee citations.Result: A concise, standards-compliant llms.txt with honest caveats.
| Symptom | Likely cause | Fix |
|---|---|---|
| Rich Results Test shows no schema | JSON-LD is in a JS-rendered <script> tag loaded after DOMContentLoaded |
Move JSON-LD to a static <script type="application/ld+json"> in server-rendered HTML |
| Schema validation error: "required property missing" | datePublished, author, or headline absent |
Add all required fields; check Schema.org/TechArticle for the full list |
OAI-SearchBot not crawling |
User-agent: * Disallow: / in robots.txt blocks all bots |
Add explicit Allow: / for OAI-SearchBot above the wildcard rule |
llms.txt not picked up by agents |
File not at https://example.com/llms.txt (must be root) |
Move file to domain root; verify it returns Content-Type: text/plain |
| Content visible in browser but not cited | Content rendered by client-side JS only | Render content server-side so crawlers receive it in the initial HTML response |
Load these files on demand — only when the task requires the detail.
| File | Load when |
|---|---|
references/pillars-and-workflow.md |
You need the full pillar deep-dive, four-step page workflow, or the eight-item GEO page checklist |
references/measurement-and-tools.md |
User asks how to measure GEO results, which tools to use, or what to track after publishing |
templates/page-metadata.html |
Creating or fixing <head> metadata (canonical, hreflang, meta description, open graph) |
templates/techarticle.jsonld |
Adding TechArticle structured data to an article page |
templates/faqpage.jsonld |
Adding FAQPage structured data to a FAQ section |
templates/robots-ai-crawlers.txt |
Updating robots.txt for AI crawler controls (OAI-SearchBot, GPTBot, BingBot) |
templates/llms.txt |
Writing or updating the site's llms.txt |
templates/quotable-article-outline.md |
Structuring article content for AI citation |