Agent skill

Programmatic SEO Planning

by AgriciDaniel in AgriciDaniel/claude-seo

Plans and audits SEO pages generated at scale from data, covering data quality, templates, URL patterns and internal links while guarding against thin content and index bloat.

MITAuto-check passedMarketing & SEO

Install Programmatic SEO Planning

skills CLI
$ npx skills add AgriciDaniel/claude-seo --skill seo-programmatic -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-seo seo-programmatic --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-programmatic .claude/skills/seo-programmatic && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-programmatic
GitHub stars
18k
Used in
2 other repos
Token cost
~2.4k tokens
SKILL.md length
1,130 words
Files
2
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Plans and audits SEO pages generated at scale from data, covering data quality, templates, URL patterns and internal links while guarding against thin content and index bloat.

  • Planning a set of pages generated from a CSV, API or database
  • SKILL.md covers Data Source Assessment, Template Engine Planning, URL Pattern Strategy and Internal Linking Automation, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Auditing template pages for thin or duplicated content

What it does

The agent starts by assessing the data behind the pages, whether CSV or JSON files, API endpoints or database queries, looking at row counts, uniqueness, missing values, freshness and records that overlap by more than 80% of their fields. It then reviews template design, separating shared static blocks from per-page dynamic ones and rejecting mad-libs pages that only swap a city or product name.

URL guidance covers patterns such as tool, location-plus-service, integration, glossary and template pages, with lowercase hyphenated slugs, unique slugs, URLs under 100 characters and no query parameters on primary content. Internal linking automation uses hub and spoke pages, three to five related links per page, breadcrumbs with BreadcrumbList schema, cross-links between pages sharing attributes and varied anchor text. Quality gates aim to prevent thin content penalties and index bloat.

When your agent uses it

  • Planning a set of pages generated from a CSV, API or database
  • Auditing template pages for thin or duplicated content
  • Designing URL patterns and internal links for pages at scale
  • Preventing index bloat from data-driven page sets

Example prompts

  • “Plan programmatic pages for our integrations directory from integrations.csv.”
  • “Audit the generated city and service pages for thin content and duplicate records.”
  • “Design the URL structure and internal linking for our glossary pages.”
  • “Check whether our template pages just swap city names into identical text.”

What it can do on your machine

Read from SKILL.md and the folder at commit 4b99de2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Programmatic SEO Planning loads about 2.4k tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 1,130 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-seo at commit 4b99de2, republished under its MIT licence (© AgriciDaniel). 1,130 words, ~2,419 tokens.

Download SKILL.mdSave it as .claude/skills/seo-programmatic/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
seo-programmatic
description
Programmatic SEO planning and analysis for pages generated at scale from data sources. Covers template engines, URL patterns, internal linking automation, thin content safeguards, and index bloat prevention. Use when user says "programmatic SEO", "pages at scale", "dynamic pages", "template pages", "generated pages", or "data-driven SEO".
user-invocable
true
argument-hint
[url or plan]
license
MIT
metadata.author
AgriciDaniel
metadata.version
2.4.2
metadata.category
seo

Programmatic SEO Analysis & Planning

Build and audit SEO pages generated at scale from structured data sources. Enforces quality gates to prevent thin content penalties and index bloat.

Data Source Assessment

Evaluate the data powering programmatic pages:

  • CSV/JSON files: Row count, column uniqueness, missing values
  • API endpoints: Response structure, data freshness, rate limits
  • Database queries: Record count, field completeness, update frequency
  • Data quality checks:
    • Each record must have enough unique attributes to generate distinct content
    • Flag duplicate or near-duplicate records (>80% field overlap)
    • Verify data freshness; stale data produces stale pages

Template Engine Planning

Design templates that produce unique, valuable pages:

  • Variable injection points: Title, H1, body sections, meta description, schema
  • Content blocks: Static (shared across pages) vs dynamic (unique per page)
  • Conditional logic: Show/hide sections based on data availability
  • Supplementary content: Related items, contextual tips, user-generated content
  • Template review checklist:
    • Each page must read as a standalone, valuable resource
    • No "mad-libs" patterns (just swapping city/product names in identical text)
    • Dynamic sections must add genuine information, not just keyword variations

URL Pattern Strategy

Common Patterns
  • /tools/[tool-name]: Tool/product directory pages
  • /[city]/[service]: Location + service pages
  • /integrations/[platform]: Integration landing pages
  • /glossary/[term]: Definition/reference pages
  • /templates/[template-name]: Downloadable template pages
URL Rules
  • Lowercase, hyphenated slugs derived from data
  • Logical hierarchy reflecting site architecture
  • No duplicate slugs; enforce uniqueness at generation time
  • Keep URLs under 100 characters
  • No query parameters for primary content URLs
  • Consistent trailing slash usage (match existing site pattern)

Internal Linking Automation

  • Hub/spoke model: Category hub pages linking to individual programmatic pages
  • Related items: Auto-link to 3-5 related pages based on data attributes
  • Breadcrumbs: Generate BreadcrumbList schema from URL hierarchy
  • Cross-linking: Link between programmatic pages sharing attributes (same category, same city, same feature)
  • Anchor text: Use descriptive, varied anchor text. Avoid exact-match keyword repetition
  • Link density: 3-5 internal links per 1000 words (match seo-content guidelines)

Thin Content Safeguards

Quality Gates
MetricThresholdAction
Pages without content review100+⚠️ WARNING: require content audit before publishing
Pages without justification500+🛑 HARD STOP: require explicit user approval and thin content audit
Unique content per page<40%❌ Flag as thin content (likely penalty risk)
Word count per page<300⚠️ Flag for review (may lack sufficient value)
Scaled Content Abuse: Enforcement Context (2025-2026)

Google's Scaled Content Abuse policy (introduced March 2024) saw major enforcement escalation in 2025:

  • June 2025: Third-party reports described a wave of manual actions against sites publishing AI-generated content at scale (no Google announcement)
  • August 2025: Third-party/SEO-community reporting described stronger SpamBrain detection for AI-generated link schemes and content farms
  • Result: Google reported 45% reduction in low-quality, unoriginal content in search results post-March 2024 enforcement

Enhanced quality gates for programmatic pages:

  • Content differentiation: ≥30-40% of content must be genuinely unique between any two programmatic pages (not just city/keyword string replacement)
  • Human review: Minimum 5-10% sample review of generated pages before publishing
  • Progressive rollout: Publish in batches of 50-100 pages. Monitor indexing and rankings for 2-4 weeks before expanding. Never publish 500+ programmatic pages simultaneously without explicit quality review.
  • Standalone value test: Each page should pass: "Would this page be worth publishing even if no other similar pages existed?"
  • Site reputation abuse: Google clarified site reputation abuse language on 2024-11-19; treat third-party/hosted programmatic content as a policy risk. Since 2026-08-30 (announced 2026-08-28) enforcement depends on the searcher: manual actions apply outside the EEA, while for EEA users the third-party section may be categorized separately from the main domain. Report the risk for both audiences.

Recommendation: The WARNING gate at <40% unique content remains appropriate. Consider a HARD STOP at <30% unique content to prevent scaled content abuse risk.

Safe Programmatic Pages (OK at scale)

✅ Integration pages (with real setup docs, API details, screenshots) ✅ Template/tool pages (with downloadable content, usage instructions) ✅ Glossary pages (200+ word definitions with examples, related terms) ✅ Product pages (unique specs, reviews, comparison data) ✅ Data-driven pages (unique statistics, charts, analysis per record)

Penalty Risk (avoid at scale)

❌ Location pages with only city name swapped in identical text ❌ "Best [tool] for [industry]" without industry-specific value ❌ "[Competitor] alternative" without real comparison data ❌ AI-generated pages without human review and unique value-add ❌ Pages where >60% of content is shared template boilerplate

Show full SKILL.md (450 more words)Show less
Uniqueness Calculation

Unique content % = (words unique to this page) / (total words on page) × 100

Measure against all other pages in the programmatic set. Shared headers, footers, and navigation are excluded from the calculation. Template boilerplate text IS included.

Metadata is scored separately. This calculation covers body copy only, so a set that passes it can still carry one generated title/description shape on every URL. Run "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run metadata_template.py --pairs-file <file> --json (heuristic, deterministic string comparison) over the whole set and treat a site_risk of high as a gate failure regardless of body uniqueness.

Canonical Strategy

  • Every programmatic page must have a self-referencing canonical tag
  • Parameter variations (sort, filter) canonical to the base URL when duplicate or low-value
  • Paginated series: use self-canonical paginated pages when content differs; keep crawlable links
  • If programmatic pages overlap with manual pages, the manual page is canonical
  • No canonical to a different domain unless intentional cross-domain setup

Sitemap Integration

  • Auto-generate sitemap entries for all programmatic pages
  • Split at 50,000 URLs or 50MB uncompressed per sitemap file, whichever comes first (protocol limit)
  • Use sitemap index if multiple sitemap files needed
  • <lastmod> reflects actual data update timestamp (not generation time)
  • Exclude noindexed programmatic pages from sitemap
  • Register sitemap in robots.txt
  • Update sitemap dynamically as new records are added to data source

Index Bloat Prevention

  • Noindex low-value pages: Pages that don't meet quality gates
  • Pagination: Reserve noindex/canonical consolidation for true duplicates or low-value filtered views
  • Faceted navigation: Reserve noindex/canonical to base category for true duplicates or low-value filtered views
  • Crawl budget: For sites with >10k programmatic pages, monitor crawl stats in Search Console
  • Thin page consolidation: Merge records with insufficient data into aggregated pages
  • Regular audits: Monthly review of indexed page count vs intended count

Output

Programmatic SEO Score: XX/100
Assessment Summary
CategoryStatusScore
Data Quality✅/⚠️/❌XX/100
Template Uniqueness✅/⚠️/❌XX/100
URL Structure✅/⚠️/❌XX/100
Internal Linking✅/⚠️/❌XX/100
Thin Content Risk✅/⚠️/❌XX/100
Index Management✅/⚠️/❌XX/100
Critical Issues (fix immediately)
High Priority (fix within 1 week)
Medium Priority (fix within 1 month)
Low Priority (backlog)
Recommendations
  • Data source improvements
  • Template modifications
  • URL pattern adjustments
  • Quality gate compliance actions

Error Handling

ScenarioAction
URL unreachableReport connection error with status code. Suggest verifying URL accessibility and checking for authentication requirements.
No programmatic pages detectedInform user that no template-generated or data-driven page patterns were found. Suggest checking if pages use client-side rendering or if the URL points to the correct section.
Thin content threshold exceededTrigger quality gate warning. Report the unique content percentage and flag pages below 40% uniqueness. Require user acknowledgment before proceeding.
Quality gate violationHalt analysis at the HARD STOP threshold (500+ pages without justification or <30% unique content). Present findings and require explicit user approval to continue.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/seo-programmatic of AgriciDaniel/claude-seo.

  • SKILL.md
  • LICENSE.txt

Open the folder on GitHubat commit 4b99de2

Used in 4 other repositories

We found 6 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AgriciDaniel/claude-seo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Programmatic SEO Planning next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Programmatic SEO Planning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Programmatic SEO Planning this skillAgriciDaniel/claude-seo18k2 repos~2.4kAutomated safety check: PassMIT
SEO Programmaticsickn33/agentic-awesome-skills47k2 repos~2.4kAutomated safety check: NotesMIT
Programmatic SEO Builderirinabuht12-oss/marketing-skills3.8k—~2.2kAutomated safety check: PassNone
Competitor Pagesindranilbanerjee/digital-marketing-pro8541 repos~2.1kAutomated safety check: PassMIT
Local Legal SEO Auditsickn33/agentic-awesome-skills47k2 repos~3.2kAutomated safety check: PassMIT
Editorial QArampstackco/claude-skills935—~5.6kAutomated safety check: PassMIT

Similar skills

  • SEO Programmatic

    sickn33/agentic-awesome-skills

    Plan and audit programmatic SEO pages generated at scale from structured data.

    47k GitHub starsUsed in 2 repos~2.4k tokens
    Marketing & SEOAuto-check: notes
  • Programmatic SEO Builder

    irinabuht12-oss/marketing-skills

    Create scalable programmatic SEO page templates with title patterns, internal linking logic, schema markup, and thin content avoidance strategies.

    3.8k GitHub stars~2.2k tokensUpdated 14 days ago
    Marketing & SEOAuto-check passed
  • Competitor Pages

    indranilbanerjee/digital-marketing-pro

    Build competitor comparison and alternatives pages — X-vs-Y head-to-heads, alternatives-to-X lists, category roundups, and feature-matrix pages — delivering a 1,500+ word page template, comparison…

    854 GitHub starsUsed in 1 repo~2.1k tokens
    Marketing & SEOAuto-check passed
  • Local Legal SEO Audit

    sickn33/agentic-awesome-skills

    Audit and improve local SEO for law firms, attorneys, forensic experts and legal/professional services sites with local presence, focusing on GBP, directories, E-E-A-T and practice/location pages.

    47k GitHub starsUsed in 2 repos~3.2k tokens
    Marketing & SEOAuto-check passed
  • Editorial QA

    rampstackco/claude-skills

    Pre-publish QA framework for content. An agent skill from rampstackco/claude-skills.

    935 GitHub stars~5.6k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Screaming Frog Tool

    garrettjsmith/localseoskills

    When the user wants a technical site audit, crawl data analysis, location page quality checks, duplicate content detection, schema validation at scale, or internal linking analysis.

    112 GitHub stars~2k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from AgriciDaniel/claude-seo

All 33 skills in this repo
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    18k GitHub starsUsed in 5 repos~3.4k tokens
    Auto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    18k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    18k GitHub starsUsed in 2 repos~3.3k tokens
    Auto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    18k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    18k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    18k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed

Categories

Questions about Programmatic SEO Planning

What does Programmatic SEO Planning do?

Plans and audits SEO pages generated at scale from data, covering data quality, templates, URL patterns and internal links while guarding against thin content and index bloat. The agent starts by assessing the data behind the pages, whether CSV or JSON files, API endpoints or database queries, looking at row counts, uniqueness, missing values, freshness and records that overlap by more than 80% of their fields. It then reviews template design, separating shared static blocks from per-page dynamic ones and rejecting mad-libs pages that only swap a city or product name.

When should I use Programmatic SEO Planning?

Programmatic SEO Planning fits situations like: planning a set of pages generated from a CSV, API or database; auditing template pages for thin or duplicated content; designing URL patterns and internal links for pages at scale; preventing index bloat from data-driven page sets.

How do I install Programmatic SEO Planning in Claude Code?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-programmatic -a claude-code`. Or copy the skill folder (skills/seo-programmatic in AgriciDaniel/claude-seo) into .claude/skills/seo-programmatic in your project. Claude Code loads it when a task matches its description.

How do I install Programmatic SEO Planning in Codex?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-programmatic -a codex`. Or copy the skill folder (skills/seo-programmatic in AgriciDaniel/claude-seo) into .agents/skills/seo-programmatic in your project. Codex loads it when a task matches its description.

Can I use Programmatic SEO Planning in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-seo --skill seo-programmatic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-programmatic, .gemini/skills/seo-programmatic, .github/skills/seo-programmatic and .opencode/skills/seo-programmatic in your project.

What does Programmatic SEO Planning need to run?

SKILL.md names no scripts, command-line tools or credentials: Programmatic SEO Planning is instructions for the agent only.

Does Programmatic SEO Planning access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Programmatic SEO Planning safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Programmatic SEO Planning use?

Programmatic SEO Planning is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Programmatic SEO Planning use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Programmatic SEO Planning?

Skills that share tags, products or a category with Programmatic SEO Planning: SEO Programmatic (sickn33/agentic-awesome-skills, 47k stars), Programmatic SEO Builder (irinabuht12-oss/marketing-skills, 3.8k stars), Competitor Pages (indranilbanerjee/digital-marketing-pro, 854 stars) and Local Legal SEO Audit (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Programmatic SEO Planning?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,426 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 4, 2026.

Source: AgriciDaniel/claude-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.