mcpbeat

Tlc Generative Engine Optimization

tech-leads-club/tlc-generative-engine-optimization

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).

7k tokens
context cost
the whole folder, loaded on every use
9
files
instructions only
0
copies elsewhere
how many repositories repackaged it
4978
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/tech-leads-club/agent-skills --skill tlc-generative-engine-optimization

The instruction itself

15 sections, as written by the author

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.txtOAI-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 |

How to use it

Copy the folder

Take tech-leads-club/tlc-generative-engine-optimization from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.