When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pages," "[keyword] + [city] pages," "comparison pages," "integration pages," or "building many pages for SEO." For auditing existing SEO issues, see seo-audit.
63
55%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./config/claude/skills/programmatic-seo/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description with excellent trigger term coverage and clear disambiguation from related skills. Its main weakness is that the 'what it does' portion could be more specific about concrete actions (e.g., generating templates, populating data fields, creating URL structures) rather than stating the high-level goal. The explicit 'when to use' guidance and cross-reference to seo-audit are notable strengths.
Suggestions
Add 2-3 specific concrete actions to the beginning, e.g., 'Generates page templates, populates them with structured data, and creates URL structures for SEO-driven pages at scale.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (SEO-driven pages at scale using templates and data) and mentions some page types (directory pages, location pages, comparison pages, integration pages), but doesn't list concrete actions like 'generate templates', 'populate data', 'create URL structures', etc. The 'what it does' is more of a high-level goal than specific actions. | 2 / 3 |
Completeness | Clearly answers both 'what' (create SEO-driven pages at scale using templates and data) and 'when' (explicit trigger terms listed with 'Also use when the user mentions...'). It even includes a disambiguation clause pointing to seo-audit for related but different tasks. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'programmatic SEO,' 'template pages,' 'pages at scale,' 'directory pages,' 'location pages,' '[keyword] + [city] pages,' 'comparison pages,' 'integration pages,' and 'building many pages for SEO.' These are highly natural phrases a user would actually use. | 3 / 3 |
Distinctiveness Conflict Risk | The description carves out a clear niche (programmatic SEO / pages at scale) distinct from general SEO work, and explicitly disambiguates from the seo-audit skill. The specific trigger terms like 'programmatic SEO,' 'directory pages,' and '[keyword] + [city] pages' are highly distinctive. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
20%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a general SEO strategy guide than an actionable skill for Claude. It is heavy on conceptual knowledge Claude already possesses (basic SEO principles, avoid thin content, etc.) and extremely light on concrete, executable guidance—no code examples, no specific tool commands, no template code. The structure is reasonable with checklists and numbered steps, but the content would benefit enormously from being trimmed to novel information and augmented with concrete implementation examples.
Suggestions
Replace abstract guidance with concrete, executable examples—e.g., show an actual page template with HTML/code, a real URL pattern generator, or a script that validates page uniqueness rather than just describing what to do.
Remove content Claude already knows: basic SEO principles (no keyword stuffing, no duplicate content), explanations of what thin content is, and general strategic advice. Focus on the specific, novel decision framework.
Move the 12 playbooks table, implementation framework details, and quality checklists into separate reference files, keeping SKILL.md as a concise overview with clear pointers.
Add concrete validation steps—e.g., specific commands or code to check for duplicate titles, measure content uniqueness scores, or verify indexation status—rather than abstract checklist items.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is very verbose with significant content Claude already knows. Sections like 'Core Principles' explain basic SEO concepts (avoid keyword stuffing, no duplicate content), 'Common Mistakes' lists obvious pitfalls, and much of the strategic guidance is general SEO knowledge rather than novel instruction. The 'Initial Assessment' questions and 'Task-Specific Questions' are largely redundant with each other. | 1 / 3 |
Actionability | The skill provides no executable code, no concrete commands, no specific templates, and no copy-paste ready examples. It reads as a strategic overview document with abstract guidance like 'Identify data sources' and 'Validate demand' without showing how to actually do any of these things. There are no concrete implementation examples—just descriptions of what should be done. | 1 / 3 |
Workflow Clarity | There is a clear sequence in the Implementation Framework (1-5 steps) and Pre-Launch/Post-Launch checklists provide validation checkpoints. However, the steps remain abstract without concrete validation mechanisms—e.g., how to actually check for thin content, how to validate indexation, or what specific tools/commands to use. The checklist format is good but lacks feedback loops for error recovery. | 2 / 3 |
Progressive Disclosure | There is one reference to a deeper file (references/playbooks.md) and related skills are mentioned at the bottom, which is good. However, the main file itself is a wall of text (~200 lines) with much content that could be split into reference files (e.g., the full 12 playbooks table, the implementation framework details, the quality checks). The overview-to-detail ratio is poor—too much detail inline. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
2c6f6e8
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.