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:
- Classic metadata fixes alone (title, description, canonical, Open Graph) → use
fixing-metadata
- Accessibility audits → use
fixing-accessibility
- Page performance and Core Web Vitals → use
web-perf
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: tlc-generative-engine-optimization3description: "Generative Engine Optimization (GEO): the on-page technical work that makes a page or site discoverable, parseable, trustworthy, quotable, and fresh for AI answer engines (Google AI Overviews, ChatGPT Search, Bing Copilot, Perplexity). Use when asked to optimize a page or site for AI search or answer engines, get a page cited by ChatGPT or Perplexity, write an llms.txt, allow or block AI crawlers in robots.txt, or add citation-ready structure and JSON-LD for AI answers. Do not use for classic title/description/Open Graph metadata alone (use fixing-metadata), accessibility (use fixing-accessibility), or page performance (use web-perf)."4metadata:5 version: '1.0.0'6 author: Fernando Paladini - github.com/paladini7 source: https://skillmd.com/skills/stanfish06/tlc-generative-engine-optimization8 upstream: https://github.com/tech-leads-club/agent-skills9license: MIT10---1112# GEO Specialist1314Expert in Generative Engine Optimization — making pages discoverable, understandable, trustworthy, quotable, and fresh for AI answer engines.1516## Philosophy1718Treat 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.1920## When to use / not use2122**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.2324**Do NOT use** for:2526- Classic metadata fixes alone (title, description, canonical, Open Graph) → use `fixing-metadata`27- Accessibility audits → use `fixing-accessibility`28- Page performance and Core Web Vitals → use `web-perf`2930## The Six GEO Pillars3132Load `references/pillars-and-workflow.md` for the full deep-dive. Summary:3334| # | Pillar | Core check |35| --- | ------------------ | ------------------------------------------------------------------------------- |36| 1 | **Discoverable** | robots.txt allows AI crawlers; sitemap exists; canonical tags correct; HTTPS |37| 2 | **Understandable** | Semantic HTML; page title matches H1; language declared; one topic per page |38| 3 | **Useful** | Content answers a specific question; content in static HTML (not JS-only) |39| 4 | **Trustworthy** | Author bio; citations/sources linked; publication + update dates visible; HTTPS |40| 5 | **Quotable** | One answer per section; short-answer paragraph before elaboration; FAQ schema |41| 6 | **Fresh** | `dateModified` in JSON-LD and meta; content reviewed when topic changes |4243## Operating Modes4445### Mode 1 — Create (new GEO-ready page)46471. Plan page structure: one topic, one H1, question-based H2s/H3s.482. Apply `templates/page-metadata.html` (canonical, hreflang, meta description).493. Add `templates/techarticle.jsonld` (or `faqpage.jsonld` for FAQ pages).504. Write content in the quotable outline pattern (`templates/quotable-article-outline.md`): short direct answer → supporting detail → sources.515. Update `robots.txt` to allow AI crawlers (`templates/robots-ai-crawlers.txt`).526. Add or update `llms.txt` if the site wants to guide AI agents (`templates/llms.txt`).537. Run the GEO page checklist (in `references/pillars-and-workflow.md`).5455### Mode 2 — Audit (score an existing page or site)56571. Crawl check: read `robots.txt` — are `OAI-SearchBot` and `BingBot` allowed?582. Structured data: validate all JSON-LD against the Rich Results Test and Schema Markup Validator.593. Pillar sweep: for each of the six pillars, mark pass / partial / fail.604. Produce a **prioritized findings table** (Pillar → Finding → Severity → Fix).615. Identify quick wins (metadata, schema, robots) vs. content rewrites.6263### Mode 3 — Improve (apply fixes)64651. Apply fixes in severity order: blockers first (crawl access, broken schema), then quick wins (metadata, dates), then content improvements.662. Re-validate structured data after every schema change.673. After changes, point to measurement tools (see `references/measurement-and-tools.md`) so the user can track AI visibility over time.6869## Guardrails7071- **Never promise** that changes will cause a specific AI engine to cite the page. Citation is an engine decision.72- **Structured data must match visible page content exactly.** Mismatches violate Google's policies and can suppress the page.73- **`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.74- **`robots.txt` is the only authoritative crawler-control file.** `llms.txt` has no effect on crawling.75- **Do not add `noindex` or `Disallow` for AI crawlers** unless the user explicitly wants to block AI indexing.76- Prefer primary platform documentation (Google Search Central, Bing Webmaster Tools, Schema.org) over third-party summaries.7778## Examples7980### Example 1 — Audit request8182**User:** "Can you audit my blog for AI search visibility?"8384**Actions:**85861. Check `robots.txt` → `OAI-SearchBot` is missing a `Disallow` but also missing an explicit `Allow` — confirm default is allow.872. Validate JSON-LD on the homepage → `datePublished` is missing, `author` has no `url`.883. Run pillar sweep → Trustworthy: partial (no author bio page); Quotable: fail (no FAQ schema on FAQ page).894. Return findings table with three priority tiers.9091**Result:** Prioritized list: fix `techarticle.jsonld`, add author bio, add `FAQPage` schema. Clear, actionable, no ranking promises.9293### Example 2 — Create request9495**User:** "Create a new GEO-optimized article page for my Next.js blog."9697**Actions:**98991. Draft `<head>` from `templates/page-metadata.html`.1002. Generate `templates/techarticle.jsonld` filled with real title, author, dates.1013. Structure content using `templates/quotable-article-outline.md`: direct-answer intro, H2/H3 sections, sources list.1024. Confirm `robots.txt` allows `OAI-SearchBot`.1035. Run checklist — all eight items pass.104105**Result:** Ready-to-deploy page with correct metadata, valid schema, and citation-ready prose.106107### Example 3 — llms.txt request108109**User:** "Write an llms.txt for my documentation site."110111**Actions:**1121131. Inventory the three or four most useful pages for an AI agent.1142. Apply `templates/llms.txt` format: H1 site name → blockquote description → `## Key pages` with Markdown links → optional `## Technical files`.1153. Remind the user that `llms.txt` is not a crawler-control file and doesn't guarantee citations.116117**Result:** A concise, standards-compliant `llms.txt` with honest caveats.118119## Troubleshooting120121| Symptom | Likely cause | Fix |122| ---------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |123| 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 |124| Schema validation error: "required property missing" | `datePublished`, `author`, or `headline` absent | Add all required fields; check Schema.org/TechArticle for the full list |125| `OAI-SearchBot` not crawling | `User-agent: *` `Disallow: /` in `robots.txt` blocks all bots | Add explicit `Allow: /` for `OAI-SearchBot` above the wildcard rule |126| `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` |127| 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 |128129## References and Templates130131Load these files on demand — only when the task requires the detail.132133| File | Load when |134| --------------------------------------- | ------------------------------------------------------------------------------------------------- |135| `references/pillars-and-workflow.md` | You need the full pillar deep-dive, four-step page workflow, or the eight-item GEO page checklist |136| `references/measurement-and-tools.md` | User asks how to measure GEO results, which tools to use, or what to track after publishing |137| `templates/page-metadata.html` | Creating or fixing `<head>` metadata (canonical, hreflang, meta description, open graph) |138| `templates/techarticle.jsonld` | Adding TechArticle structured data to an article page |139| `templates/faqpage.jsonld` | Adding FAQPage structured data to a FAQ section |140| `templates/robots-ai-crawlers.txt` | Updating `robots.txt` for AI crawler controls (OAI-SearchBot, GPTBot, BingBot) |141| `templates/llms.txt` | Writing or updating the site's `llms.txt` |142| `templates/quotable-article-outline.md` | Structuring article content for AI citation |