/digital-marketing-pro:programmatic-seo
Purpose
Plan and audit SEO pages generated at scale from structured data sources (databases, APIs, CSV/JSON files). Enforces quality gates to prevent thin content penalties, index bloat, and Google's Scaled Content Abuse policy.
Input Required
The user must provide (or will be prompted for):
- URL or data source: Existing programmatic pages to audit, or data source details for planning
- Page type: What kind of pages are being generated (location, product, integration, glossary, template, tool)
- Data source: CSV/JSON files, API endpoints, database queries — or existing pages to analyze
- Target scale: How many pages will be generated
- Current status: New build or auditing existing programmatic pages
Process
- Load brand context: Read
~/.claude-marketing/brands/_active-brand.json for the active slug, then load ~/.claude-marketing/brands/{slug}/profile.json. Apply industry context and compliance rules. Check for brand guidelines at ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json.
- Data source assessment: Evaluate the data powering programmatic pages — row count, column uniqueness, missing values, duplicate detection (>80% field overlap), data freshness
- Template engine planning: Design templates that produce genuinely unique pages — variable injection points, content blocks (static vs dynamic), conditional logic, supplementary content. Validate each page passes the "standalone value test"
- URL pattern strategy: Design URL hierarchy — lowercase hyphenated slugs, logical structure, uniqueness enforcement, under 100 characters, consistent trailing slash
- Internal linking automation: Hub/spoke model, related items (3-5 per page), breadcrumbs with BreadcrumbList schema, cross-linking by shared attributes, varied anchor text
- Thin content safeguard check: Apply quality gates (see below)
- Canonical strategy: Self-referencing canonicals, parameter handling, pagination strategy, manual page priority
- Sitemap integration: Auto-generate entries, split at 50K URLs,
<lastmod> from actual data timestamps, exclude noindexed pages
- Index bloat prevention: Noindex low-value pages, pagination handling, faceted navigation canonicalization, crawl budget monitoring for 10K+ pages
- Score and report: Score each dimension, produce prioritized action plan
Quality Gates
Scale Thresholds
| Metric |
Threshold |
Action |
| Pages without content review |
100+ |
WARNING: require content audit before publishing |
| Pages without justification |
500+ |
HARD STOP: require explicit user approval and thin content audit |
| Unique content per page |
<40% |
Flag as thin content (penalty risk) |
| Unique content per page |
<30% |
HARD STOP: scaled content abuse risk |
| Word count per page |
<300 |
Flag for review (may lack sufficient value) |
Scaled Content Abuse Context (2025-2026)
Google's Scaled Content Abuse policy (introduced March 2024) saw major enforcement escalation:
- June 2025: Wave of manual actions targeting AI-generated content at scale
- August 2025: SpamBrain update enhanced pattern detection for AI-generated link schemes and content farms
- Result: 45% reduction in low-quality, unoriginal content in search results
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+ simultaneously without 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: Publishing programmatic content under a high-authority domain (not your own) may trigger site reputation abuse penalties (enforced aggressively since November 2024)
Safe vs Risky Programmatic Pages
Safe 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 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
Uniqueness Calculation
Unique content % = (words unique to this page) / (total words on page) x 100
Measured against all other pages in the programmatic set. Shared headers, footers, and navigation excluded. Template boilerplate IS included.
URL Pattern Library
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
/compare/[product-a]-vs-[product-b]: Comparison 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)
Output
A structured programmatic SEO assessment containing:
Programmatic SEO Score: XX/100
| Category |
Status |
Score |
| Data Quality |
score |
/100 |
| Template Uniqueness |
score |
/100 |
| URL Structure |
score |
/100 |
| Internal Linking |
score |
/100 |
| Thin Content Risk |
score |
/100 |
| Index Management |
score |
/100 |
- Critical issues (fix immediately)
- High priority (fix within 1 week)
- Medium priority (fix within 1 month)
- Recommendations: data source improvements, template modifications, URL pattern adjustments, quality gate compliance actions
- Progressive rollout plan with batch sizes and monitoring checkpoints
Agents Used
- seo-specialist — Programmatic page analysis, quality gate enforcement, URL strategy, template evaluation
- content-creator — Template content design, uniqueness optimization
Scripts Used
- tech-seo-auditor.py — Check technical SEO issues across programmatic page samples
- content-scorer.py — Score content quality and uniqueness per template
- competitor-scraper.py — Analyze competitor programmatic page patterns
Source: hashgraph-online/awesome-codex-plugins → plugins/indranilbanerjee/digital-marketing-pro/skills/programmatic-seo/SKILL.md
1---
2name: programmatic-seo-4
3description: "Plan programmatic SEO pages. Use when: building template engines, URL patterns, thin content safeguards, or quality gates."
4category: marketing-and-growth
5source_repo: hashgraph-online/awesome-codex-plugins
6source_path: "plugins/indranilbanerjee/digital-marketing-pro/skills/programmatic-seo/SKILL.md"
7source_url: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/indranilbanerjee/digital-marketing-pro/skills/programmatic-seo/SKILL.md
8metadata:
9 source: https://skillmd.com/skills/hashgraph-online/programmatic-seo-4
10---
11
12
13# /digital-marketing-pro:programmatic-seo
14
15## Purpose
16
17Plan and audit SEO pages generated at scale from structured data sources (databases, APIs, CSV/JSON files). Enforces quality gates to prevent thin content penalties, index bloat, and Google's Scaled Content Abuse policy.
18
19## Input Required
20
21The user must provide (or will be prompted for):
22
23- **URL or data source**: Existing programmatic pages to audit, or data source details for planning
24- **Page type**: What kind of pages are being generated (location, product, integration, glossary, template, tool)
25- **Data source**: CSV/JSON files, API endpoints, database queries — or existing pages to analyze
26- **Target scale**: How many pages will be generated
27- **Current status**: New build or auditing existing programmatic pages
28
29## Process
30
311. **Load brand context**: Read `~/.claude-marketing/brands/_active-brand.json` for the active slug, then load `~/.claude-marketing/brands/{slug}/profile.json`. Apply industry context and compliance rules. Check for brand guidelines at `~/.claude-marketing/brands/{slug}/guidelines/_manifest.json`.
322. **Data source assessment**: Evaluate the data powering programmatic pages — row count, column uniqueness, missing values, duplicate detection (>80% field overlap), data freshness
333. **Template engine planning**: Design templates that produce genuinely unique pages — variable injection points, content blocks (static vs dynamic), conditional logic, supplementary content. Validate each page passes the "standalone value test"
344. **URL pattern strategy**: Design URL hierarchy — lowercase hyphenated slugs, logical structure, uniqueness enforcement, under 100 characters, consistent trailing slash
355. **Internal linking automation**: Hub/spoke model, related items (3-5 per page), breadcrumbs with BreadcrumbList schema, cross-linking by shared attributes, varied anchor text
366. **Thin content safeguard check**: Apply quality gates (see below)
377. **Canonical strategy**: Self-referencing canonicals, parameter handling, pagination strategy, manual page priority
388. **Sitemap integration**: Auto-generate entries, split at 50K URLs, `<lastmod>` from actual data timestamps, exclude noindexed pages
399. **Index bloat prevention**: Noindex low-value pages, pagination handling, faceted navigation canonicalization, crawl budget monitoring for 10K+ pages
4010. **Score and report**: Score each dimension, produce prioritized action plan
41
42## Quality Gates
43
44### Scale Thresholds
45
46| Metric | Threshold | Action |
47|--------|-----------|--------|
48| Pages without content review | 100+ | WARNING: require content audit before publishing |
49| Pages without justification | 500+ | HARD STOP: require explicit user approval and thin content audit |
50| Unique content per page | <40% | Flag as thin content (penalty risk) |
51| Unique content per page | <30% | HARD STOP: scaled content abuse risk |
52| Word count per page | <300 | Flag for review (may lack sufficient value) |
53
54### Scaled Content Abuse Context (2025-2026)
55
56Google's Scaled Content Abuse policy (introduced March 2024) saw major enforcement escalation:
57
58- **June 2025**: Wave of manual actions targeting AI-generated content at scale
59- **August 2025**: SpamBrain update enhanced pattern detection for AI-generated link schemes and content farms
60- **Result**: 45% reduction in low-quality, unoriginal content in search results
61
62**Enhanced quality gates for programmatic pages:**
63
64- **Content differentiation**: 30-40%+ of content must be genuinely unique between any two programmatic pages (not just city/keyword string replacement)
65- **Human review**: Minimum 5-10% sample review of generated pages before publishing
66- **Progressive rollout**: Publish in batches of 50-100 pages. Monitor indexing and rankings for 2-4 weeks before expanding. Never publish 500+ simultaneously without quality review.
67- **Standalone value test**: Each page should pass: "Would this page be worth publishing even if no other similar pages existed?"
68- **Site reputation abuse**: Publishing programmatic content under a high-authority domain (not your own) may trigger site reputation abuse penalties (enforced aggressively since November 2024)
69
70### Safe vs Risky Programmatic Pages
71
72**Safe at scale:**
73- Integration pages (with real setup docs, API details, screenshots)
74- Template/tool pages (with downloadable content, usage instructions)
75- Glossary pages (200+ word definitions with examples, related terms)
76- Product pages (unique specs, reviews, comparison data)
77- Data-driven pages (unique statistics, charts, analysis per record)
78
79**Penalty risk at scale:**
80- Location pages with only city name swapped in identical text
81- "Best [tool] for [industry]" without industry-specific value
82- "[Competitor] alternative" without real comparison data
83- AI-generated pages without human review and unique value-add
84- Pages where >60% of content is shared template boilerplate
85
86### Uniqueness Calculation
87
88Unique content % = (words unique to this page) / (total words on page) x 100
89
90Measured against all other pages in the programmatic set. Shared headers, footers, and navigation excluded. Template boilerplate IS included.
91
92## URL Pattern Library
93
94### Common Patterns
95- `/tools/[tool-name]`: Tool/product directory pages
96- `/[city]/[service]`: Location + service pages
97- `/integrations/[platform]`: Integration landing pages
98- `/glossary/[term]`: Definition/reference pages
99- `/templates/[template-name]`: Downloadable template pages
100- `/compare/[product-a]-vs-[product-b]`: Comparison pages
101
102### URL Rules
103- Lowercase, hyphenated slugs derived from data
104- Logical hierarchy reflecting site architecture
105- No duplicate slugs — enforce uniqueness at generation time
106- Keep URLs under 100 characters
107- No query parameters for primary content URLs
108- Consistent trailing slash usage (match existing site pattern)
109
110## Output
111
112A structured programmatic SEO assessment containing:
113
114### Programmatic SEO Score: XX/100
115
116| Category | Status | Score |
117|----------|--------|-------|
118| Data Quality | score | /100 |
119| Template Uniqueness | score | /100 |
120| URL Structure | score | /100 |
121| Internal Linking | score | /100 |
122| Thin Content Risk | score | /100 |
123| Index Management | score | /100 |
124
125- Critical issues (fix immediately)
126- High priority (fix within 1 week)
127- Medium priority (fix within 1 month)
128- Recommendations: data source improvements, template modifications, URL pattern adjustments, quality gate compliance actions
129- Progressive rollout plan with batch sizes and monitoring checkpoints
130
131## Agents Used
132
133- **seo-specialist** — Programmatic page analysis, quality gate enforcement, URL strategy, template evaluation
134- **content-creator** — Template content design, uniqueness optimization
135
136## Scripts Used
137
138- **tech-seo-auditor.py** — Check technical SEO issues across programmatic page samples
139- **content-scorer.py** — Score content quality and uniqueness per template
140- **competitor-scraper.py** — Analyze competitor programmatic page patterns
141
142---
143
144**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/indranilbanerjee/digital-marketing-pro/skills/programmatic-seo/SKILL.md`