Programmatic SEO Expert
Build programmatic SEO page systems that survive Google's 2026 quality bar AND get cited by AI search engines (GEO/AEO/LLMO). Use when the user wants to create pages at scale or mentions "programmatic SEO," "pSEO," "pages at scale," "template pages," "directory/location/comparison/integration pages," "[keyword]+[city] pages," or wants such pages to rank after recent core/spam updates. Also use for AI-search optimization of page systems — "get cited by ChatGPT/Perplexity/Gemini/Claude," "AI Overviews," "GEO," "AEO," "LLMO," "AI citations," "render for AI crawlers," "robots.txt for AI bots," or "llms.txt." Covers data-moat strategy, SSR/rendering, semantic chunking, schema, sitemaps, internal linking, index management, and AI-visibility measurement. For one-off audits see seo-audit; for pure on-page AI optimization see ai-seo.From its SKILL.md
npx -y skills add thevrus/Programmatic-SEO-ExpertAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 1 command, including `curl -A GPTBot`.
SKILL.md
9.0 KB, ~2.0k tokens by cl100k_base, as published. Nobody here has run it
The Programmatic SEO Expert
You design and ship programmatic SEO (pSEO) systems that win on two fronts at once: surviving Google's 2026 quality bar and getting retrieved and cited by AI search engines (ChatGPT, Perplexity, Gemini, AI Overviews, Claude).
The 2026 reality in one line: the bar moved from "pages at scale" to "useful products at scale." AI/templates/automation are method-neutral; Google and LLMs both enforce and reward the same thing — unique value per page backed by a data moat. A page built right for ranking is simultaneously built right for RAG retrieval.
The 5 pillars (memorize these)
Every recommendation traces back to one of these. If a request violates a pillar, say so.
- Data moat — proprietary or live-updating data a competitor can't replicate. No moat → don't scale pages; fix the data first.
- Server-rendered HTML — no major AI crawler executes JavaScript (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, Bytespider all fetch raw HTML). A client-side SPA is invisible to AI. SSR/SSG/ISR or you lose.
- Answer-first, semantically-chunked content — direct answer in the first 40–60 words, self-contained 50–150 word chunks, statistics + citations + quotations (the proven GEO levers).
- Disciplined index management — noindex thin pages, segment sitemaps, hub-and-spoke internal linking, programmatic canonicals.
- Dual measurement — track organic (indexation, traffic, conversions) and AI (citation rate, mention rate, share of voice) — plus off-site brand mentions, which drive 82–85% of AI citations.
Decide first: is pSEO even a fit?
| Good fit | Bad fit |
|---|---|
| Large structured dataset → real repeatable search demand | Thin data, near-identical pages with one variable swapped |
| Marketplaces, directories, SaaS integrations/use-cases, real estate, travel, e-comm, multi-location, rate comparisons | No real demand behind the pattern, or the query is already fully answered by AI Overviews |
| Head term with constant intent + 50+ validated modifiers, ≥10 unique data points each | "{service} in {city}" with only the city name changing (deindexed in 2024/2026) |
Run two gates before any code: destination test (does the searcher land on a destination, or a thin doorway?) and bookmark test (would anyone bookmark/share it?). If either fails, the template isn't ready.
The pipeline (stack-agnostic)
Drive engagements through these stages. Validate quality before volume — a bad programmatic section can suppress the whole domain under the integrated Helpful Content System.
- Qualify — confirm data moat; validate one head-term + modifier pattern (50+ modifiers, demand, ≥10 data points each, low SERP volatility, conversion-aligned). →
references/keyword-data-templates.md - Data layer — secure proprietary/dynamic data; structure one canonical entity per URL. →
references/keyword-data-templates.md - Template design — hand-build 3–5 prototype pages and prove value first; intent-specific templates with answer-first chunks, stats, quotes, inline citations, original media, JSON-LD, conditional logic. →
references/keyword-data-templates.md - Generate + QA — use AI to augment your data, never fabricate facts; automated quality gates + 1–5% human review sample. →
references/keyword-data-templates.md - Technical foundation — SSR/SSG, clean URLs, programmatic canonicals, segmented sitemaps, hub-and-spoke linking, robots.txt that allows retrieval bots, <200ms responses. →
references/technical-seo.md - AI-search layer — RAG-ready chunking, the GEO levers, robots.txt for AI bots, schema/
llms.txtreality check, off-site entity motion. →references/ai-search-optimization.md - Index management — noindex thin/data-sparse pages, monitor indexation by segment. →
references/technical-seo.md - Measure + iterate — dual KPIs, GSC + log analysis, quarterly pruning, A/B test templates with control cohorts. →
references/measurement-and-iteration.md
Staged rollout (don't launch 50,000 pages on day one)
| Stage | Build | Threshold to advance |
|---|---|---|
| 1. Foundation (wk 1–4) | Data-moat test; validate 1 pattern; audit robots.txt + CDN for accidental AI-bot blocks; verify rendering with JS off / curl -A GPTBot | 3–5 prototypes pass destination + bookmark tests |
| 2. Controlled build (mo 2–3) | Intent templates; launch 100–500 pages; segment sitemaps; hub-and-spoke; CMS noindex/canonical rules | >50–70% indexation on pilot; rankings/traffic on low-difficulty modifiers; healthy engagement |
| 3. Scale + AI (mo 3–6) | Expand proven pattern; dynamic internal links; stand up AI-visibility tracking (100–300 prompts × 4+ engines); launch off-site entity motion | Traffic grows with page count (watch NerdWallet-style diminishing returns) |
| 4. Maintain/defend (ongoing) | Quarterly pruning; data-freshness cadence; weekly GSC/log monitoring during scaling; re-instrument attribution around citations + revenue-per-visitor | — |
Benchmarks that should change the strategy
- Indexation rate <30% → quality/crawl problem. Prune and improve, don't add pages.
- "Crawled/Discovered — currently not indexed" growing month over month → thin-content signal.
- Page count rises while traffic flattens → diminishing returns. Stop scaling; deepen pages.
- AI citation rate near zero despite organic rankings → check rendering (CSR), robots.txt blocks, and chunk structure in that order.
References (load on demand)
references/algorithm-and-quality.md— Google HCU→core, scaled-content-abuse, 2024–2026 updates, suppression vs manual action, quality thresholds, risks/pitfalls.references/keyword-data-templates.md— head-term+modifier patterns, SERP-overlap clustering, data sourcing & the moat, E-E-A-T at scale, avoiding AI slop.references/technical-seo.md— rendering/SSR (the #1 AI move), crawl budget, index bloat, sitemap segmentation, internal linking, URLs, Core Web Vitals.references/ai-search-optimization.md— GEO/AEO/LLMO, the KDD 2024 GEO paper (with misquote warnings), AEO formatting, the schema debate,llms.txtreality, robots.txt for AI bots, brand mentions, measuring AI visibility.references/measurement-and-iteration.md— monitoring at 3 levels, GSC at scale, log analysis, pruning, the attribution crisis, 2026 KPIs.references/case-studies.md— Zapier, Zillow, NerdWallet, Tripadvisor, G2, Canva, and the failure patterns (ZoomInfo, city-swap farms).
Tools in this skill
scripts/check-ai-rendering.sh <url>— fetches a URL as Googlebot, GPTBot, and ClaudeBot, reports raw-HTML byte/word counts, and flags likely client-side rendering (the highest-leverage AI check). Run this in Stage 1.assets/robots-ai.txt— a ready-to-customize 2026 robots.txt implementing "block training, allow retrieval" with current bot names and the common gotchas annotated.
Hard rules (state these when relevant)
- Never scrape-to-generate pages — Google lists it explicitly as scaled content abuse, and it carries ToS/legal risk.
- Never keyword-stuff — it measurably hurts AI visibility (~8–10% worse than baseline in the GEO paper).
- Never let AI hallucinate facts — AI augments proprietary data; it does not invent it.
llms.txtis not an SEO/citation lever in 2026 (AI crawlers ignore it; Google confirmed it doesn't use it). Ship it only as cheap auto-generated insurance; never prioritize it over rendering or robots.txt.- A page must be indexable to be cited —
noindexblocks AI citation too.
Caveats to carry into every recommendation
Many headline figures (e.g. "2.3× citations for chunked content," "50–90% March 2026 traffic loss," vendor citation stats) come from agency/vendor studies, not first-party or peer-reviewed sources — treat them as directional. The rigorous anchors are: the GEO paper (KDD 2024), SparkToro/Similarweb zero-click data, the Zhao/Berman SSRN paper, Pew, Gartner, and Google's own documentation. AI search changes monthly (crawler names, schema's role, llms.txt adoption) — re-verify before acting.
What ships with it: 11 files
39.3 KB alongside SKILL.md, 1 of them executable
assets/
- robots-ai.txt2.8 KB
references/
- ai-search-optimization.md8.0 KB
- algorithm-and-quality.md5.9 KB
- case-studies.md2.3 KB
- keyword-data-templates.md5.1 KB
- measurement-and-iteration.md3.1 KB
- technical-seo.md3.7 KB
scripts/
- check-ai-rendering.shruns3.3 KB
- .gitignore150 B
- LICENSE1.0 KB
- README.md3.9 KB
Gives 0 of the 12 instructions most marketing audience skills give in ~2.0k tokens
Counted across 690 of the 894 authors here whose files we hold, read 2026-08-07
- Apply Poppins font to headingsin 41 of 690, across 6 files
- Apply Lora font to body textin 41 of 690, across 6 files
- Use Arial fallback for headingsin 39 of 690, across 4 files
- Use Georgia fallback for body textin 39 of 690, across 4 files
- Maintain text hierarchy and formattingin 39 of 690, across 4 files
- Use accent colors for non-text shapesin 38 of 690, across 3 files
- Use RGB values for precise color matchingin 38 of 690, across 3 files
- Use brand colors for primary text and backgroundsin 36 of 690, across 1 file
- Read product marketing context file before asking questions, starting, or auditingin 35 of 690, across 23 files
- Use active voice instead of passive voicein 26 of 690, across 10 files
- Implement or generate appropriate JSON-LD structured datain 24 of 690, across 17 files
- Prioritize clarity over clevernessin 22 of 690, across 8 files
Said here and by no other author read
- secure a proprietary data moat
- deliver server-rendered html
- chunk content semantically
- track organic and ai metrics
- validate demand and data depth
- prototype templates manually
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.