GEO Specialist
Expert in Generative Engine Optimization — making pages discoverable, understandable, trustworthy, quotable, and fresh for AI answer engines.
Philosophy
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.
When to use / not use
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-driven content strategy or programmatic pages at scale → use
ai-seo
- Classic keyword/SERP ranking work → use
seo
- Accessibility audits → use
web-accessibility
- Multi-area site health audits → use
web-quality-audit
The Six GEO Pillars
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 |
Operating Modes
Mode 1 — Create (new GEO-ready page)
- Plan page structure: one topic, one H1, question-based H2s/H3s.
- Apply
templates/page-metadata.html (canonical, hreflang, meta description).
- Add
templates/techarticle.jsonld (or faqpage.jsonld for FAQ pages).
- Write content in the quotable outline pattern (
templates/quotable-article-outline.md): short direct answer → supporting detail → sources.
- Update
robots.txt to allow AI crawlers (templates/robots-ai-crawlers.txt).
- Add or update
llms.txt if the site wants to guide AI agents (templates/llms.txt).
- Run the GEO page checklist (in
references/pillars-and-workflow.md).
Mode 2 — Audit (score an existing page or site)
- Crawl check: read
robots.txt — are OAI-SearchBot and BingBot allowed?
- Structured data: validate all JSON-LD against the Rich Results Test and Schema Markup Validator.
- Pillar sweep: for each of the six pillars, mark pass / partial / fail.
- Produce a prioritized findings table (Pillar → Finding → Severity → Fix).
- Identify quick wins (metadata, schema, robots) vs. content rewrites.
Mode 3 — Improve (apply fixes)
- Apply fixes in severity order: blockers first (crawl access, broken schema), then quick wins (metadata, dates), then content improvements.
- Re-validate structured data after every schema change.
- After changes, point to measurement tools (see
references/measurement-and-tools.md) so the user can track AI visibility over time.
Guardrails
- Never promise that changes will cause a specific AI engine to cite the page. Citation is an engine decision.
- Structured data must match visible page content exactly. Mismatches violate Google's policies and can suppress the page.
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.- Do not add
noindex or Disallow for AI crawlers unless the user explicitly wants to block AI indexing.
- Prefer primary platform documentation (Google Search Central, Bing Webmaster Tools, Schema.org) over third-party summaries.
Examples
Example 1 — Audit request
User: "Can you audit my blog for AI search visibility?"
Actions:
- Check
robots.txt → OAI-SearchBot is missing a Disallow but also missing an explicit Allow — confirm default is allow.
- Validate JSON-LD on the homepage →
datePublished is missing, author has no url.
- Run pillar sweep → Trustworthy: partial (no author bio page); Quotable: fail (no FAQ schema on FAQ page).
- Return findings table with three priority tiers.
Result: Prioritized list: fix techarticle.jsonld, add author bio, add FAQPage schema. Clear, actionable, no ranking promises.
Example 2 — Create request
User: "Create a new GEO-optimized article page for my Next.js blog."
Actions:
- Draft
<head> from templates/page-metadata.html.
- Generate
templates/techarticle.jsonld filled with real title, author, dates.
- Structure content using
templates/quotable-article-outline.md: direct-answer intro, H2/H3 sections, sources list.
- Confirm
robots.txt allows OAI-SearchBot.
- Run checklist — all eight items pass.
Result: Ready-to-deploy page with correct metadata, valid schema, and citation-ready prose.
Example 3 — llms.txt request
User: "Write an llms.txt for my documentation site."
Actions:
- Inventory the three or four most useful pages for an AI agent.
- Apply
templates/llms.txt format: H1 site name → blockquote description → ## Key pages with Markdown links → optional ## Technical files.
- Remind the user that
llms.txt is not a crawler-control file and doesn't guarantee citations.
Result: A concise, standards-compliant llms.txt with honest caveats.
Troubleshooting
| 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 |
References and Templates
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 |
1---2name: pbs-generative-engine-optimization3description: Generative Engine Optimization (GEO) specialist — the technical, on-page publishing work that makes a given page or site discoverable, understandable, trustworthy, quotable, and fresh for AI answer engines (Google AI Overviews, ChatGPT Search, Bing Copilot, Perplexity). Use when asked to 'optimize this page/site for GEO', 'optimize for AI search / answer engines', 'get my page cited by ChatGPT/Perplexity', 'improve AI visibility/citability', 'write an llms.txt', 'add citation-ready structure or schema for AI answers', 'otimizar para busca com IA', or to audit/create/improve a codebase for generative search. Do NOT use for AI-driven SEO content strategy or programmatic pages at scale (use ai-seo), classic keyword/SERP ranking (use seo), accessibility (use web-accessibility), or multi-area site audits (use web-quality-audit).4license: MIT5---67# GEO Specialist89Expert in Generative Engine Optimization — making pages discoverable, understandable, trustworthy, quotable, and fresh for AI answer engines.1011## Philosophy1213Treat 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.1415## When to use / not use1617**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.1819**Do NOT use** for:2021- AI-driven content strategy or programmatic pages at scale → use `ai-seo`22- Classic keyword/SERP ranking work → use `seo`23- Accessibility audits → use `web-accessibility`24- Multi-area site health audits → use `web-quality-audit`2526## The Six GEO Pillars2728Load `references/pillars-and-workflow.md` for the full deep-dive. Summary:2930| # | Pillar | Core check |31| --- | ------------------ | ------------------------------------------------------------------------------- |32| 1 | **Discoverable** | robots.txt allows AI crawlers; sitemap exists; canonical tags correct; HTTPS |33| 2 | **Understandable** | Semantic HTML; page title matches H1; language declared; one topic per page |34| 3 | **Useful** | Content answers a specific question; content in static HTML (not JS-only) |35| 4 | **Trustworthy** | Author bio; citations/sources linked; publication + update dates visible; HTTPS |36| 5 | **Quotable** | One answer per section; short-answer paragraph before elaboration; FAQ schema |37| 6 | **Fresh** | `dateModified` in JSON-LD and meta; content reviewed when topic changes |3839## Operating Modes4041### Mode 1 — Create (new GEO-ready page)42431. Plan page structure: one topic, one H1, question-based H2s/H3s.442. Apply `templates/page-metadata.html` (canonical, hreflang, meta description).453. Add `templates/techarticle.jsonld` (or `faqpage.jsonld` for FAQ pages).464. Write content in the quotable outline pattern (`templates/quotable-article-outline.md`): short direct answer → supporting detail → sources.475. Update `robots.txt` to allow AI crawlers (`templates/robots-ai-crawlers.txt`).486. Add or update `llms.txt` if the site wants to guide AI agents (`templates/llms.txt`).497. Run the GEO page checklist (in `references/pillars-and-workflow.md`).5051### Mode 2 — Audit (score an existing page or site)52531. Crawl check: read `robots.txt` — are `OAI-SearchBot` and `BingBot` allowed?542. Structured data: validate all JSON-LD against the Rich Results Test and Schema Markup Validator.553. Pillar sweep: for each of the six pillars, mark pass / partial / fail.564. Produce a **prioritized findings table** (Pillar → Finding → Severity → Fix).575. Identify quick wins (metadata, schema, robots) vs. content rewrites.5859### Mode 3 — Improve (apply fixes)60611. Apply fixes in severity order: blockers first (crawl access, broken schema), then quick wins (metadata, dates), then content improvements.622. Re-validate structured data after every schema change.633. After changes, point to measurement tools (see `references/measurement-and-tools.md`) so the user can track AI visibility over time.6465## Guardrails6667- **Never promise** that changes will cause a specific AI engine to cite the page. Citation is an engine decision.68- **Structured data must match visible page content exactly.** Mismatches violate Google's policies and can suppress the page.69- **`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.70- **`robots.txt` is the only authoritative crawler-control file.** `llms.txt` has no effect on crawling.71- **Do not add `noindex` or `Disallow` for AI crawlers** unless the user explicitly wants to block AI indexing.72- Prefer primary platform documentation (Google Search Central, Bing Webmaster Tools, Schema.org) over third-party summaries.7374## Examples7576### Example 1 — Audit request7778**User:** "Can you audit my blog for AI search visibility?"7980**Actions:**81821. Check `robots.txt` → `OAI-SearchBot` is missing a `Disallow` but also missing an explicit `Allow` — confirm default is allow.832. Validate JSON-LD on the homepage → `datePublished` is missing, `author` has no `url`.843. Run pillar sweep → Trustworthy: partial (no author bio page); Quotable: fail (no FAQ schema on FAQ page).854. Return findings table with three priority tiers.8687**Result:** Prioritized list: fix `techarticle.jsonld`, add author bio, add `FAQPage` schema. Clear, actionable, no ranking promises.8889### Example 2 — Create request9091**User:** "Create a new GEO-optimized article page for my Next.js blog."9293**Actions:**94951. Draft `<head>` from `templates/page-metadata.html`.962. Generate `templates/techarticle.jsonld` filled with real title, author, dates.973. Structure content using `templates/quotable-article-outline.md`: direct-answer intro, H2/H3 sections, sources list.984. Confirm `robots.txt` allows `OAI-SearchBot`.995. Run checklist — all eight items pass.100101**Result:** Ready-to-deploy page with correct metadata, valid schema, and citation-ready prose.102103### Example 3 — llms.txt request104105**User:** "Write an llms.txt for my documentation site."106107**Actions:**1081091. Inventory the three or four most useful pages for an AI agent.1102. Apply `templates/llms.txt` format: H1 site name → blockquote description → `## Key pages` with Markdown links → optional `## Technical files`.1113. Remind the user that `llms.txt` is not a crawler-control file and doesn't guarantee citations.112113**Result:** A concise, standards-compliant `llms.txt` with honest caveats.114115## Troubleshooting116117| Symptom | Likely cause | Fix |118| ---------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |119| 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 |120| Schema validation error: "required property missing" | `datePublished`, `author`, or `headline` absent | Add all required fields; check Schema.org/TechArticle for the full list |121| `OAI-SearchBot` not crawling | `User-agent: *` `Disallow: /` in `robots.txt` blocks all bots | Add explicit `Allow: /` for `OAI-SearchBot` above the wildcard rule |122| `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` |123| 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 |124125## References and Templates126127Load these files on demand — only when the task requires the detail.128129| File | Load when |130| --------------------------------------- | ------------------------------------------------------------------------------------------------- |131| `references/pillars-and-workflow.md` | You need the full pillar deep-dive, four-step page workflow, or the eight-item GEO page checklist |132| `references/measurement-and-tools.md` | User asks how to measure GEO results, which tools to use, or what to track after publishing |133| `templates/page-metadata.html` | Creating or fixing `<head>` metadata (canonical, hreflang, meta description, open graph) |134| `templates/techarticle.jsonld` | Adding TechArticle structured data to an article page |135| `templates/faqpage.jsonld` | Adding FAQPage structured data to a FAQ section |136| `templates/robots-ai-crawlers.txt` | Updating `robots.txt` for AI crawler controls (OAI-SearchBot, GPTBot, BingBot) |137| `templates/llms.txt` | Writing or updating the site's `llms.txt` |138| `templates/quotable-article-outline.md` | Structuring article content for AI citation |
Peterson-Benhame