agentsclimarketplace

Programmatic SEO Expert

Skill thevrus/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

Install
npx -y skills add thevrus/Programmatic-SEO-Expert

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

  1. Data moat — proprietary or live-updating data a competitor can't replicate. No moat → don't scale pages; fix the data first.
  2. Server-rendered HTMLno 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.
  3. 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).
  4. Disciplined index management — noindex thin pages, segment sitemaps, hub-and-spoke internal linking, programmatic canonicals.
  5. 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 fitBad fit
Large structured dataset → real repeatable search demandThin data, near-identical pages with one variable swapped
Marketplaces, directories, SaaS integrations/use-cases, real estate, travel, e-comm, multi-location, rate comparisonsNo 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.

  1. 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
  2. Data layer — secure proprietary/dynamic data; structure one canonical entity per URL. → references/keyword-data-templates.md
  3. 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
  4. Generate + QA — use AI to augment your data, never fabricate facts; automated quality gates + 1–5% human review sample. → references/keyword-data-templates.md
  5. 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
  6. AI-search layer — RAG-ready chunking, the GEO levers, robots.txt for AI bots, schema/llms.txt reality check, off-site entity motion. → references/ai-search-optimization.md
  7. Index management — noindex thin/data-sparse pages, monitor indexation by segment. → references/technical-seo.md
  8. 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)

StageBuildThreshold 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 GPTBot3–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 motionTraffic 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.txt reality, 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.txt is 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 citednoindex blocks 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/

scripts/

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.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.