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.
50
55%
Does it follow best practices?
Impact
—
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 skill description with excellent trigger term coverage and completeness. The explicit 'when to use' guidance and disambiguation from the seo-audit skill are particularly well done. The main weakness is that the 'what it does' portion could be more specific about the concrete actions performed (e.g., generating template files, populating data, creating URL structures).
Suggestions
Add 2-3 more specific concrete actions to the 'what' portion, e.g., 'Generates template-based HTML pages, populates data from CSV/JSON sources, creates URL structures and internal linking patterns 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 implies actions like creating pages, but doesn't list multiple specific concrete actions such as 'generate template files, populate data variables, create URL structures, build sitemaps.' | 2 / 3 |
Completeness | Clearly answers both 'what' (create SEO-driven pages at scale using templates and data) and 'when' (explicit 'Use when' clause with extensive trigger terms). Also includes a helpful disambiguation pointer 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 and comprehensive. | 3 / 3 |
Distinctiveness Conflict Risk | Very distinct niche focused on programmatic SEO page generation at scale, with clear differentiation from general SEO auditing (explicitly referencing seo-audit as a separate skill). The specific trigger terms like 'directory pages,' 'location pages,' and '[keyword] + [city] pages' make it highly distinguishable. | 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 verbose, restating many concepts Claude already knows, while lacking the concrete code examples, template markup, or executable commands that would make it truly actionable. The workflow structure is reasonable but would benefit from validation feedback loops and concrete implementation artifacts.
Suggestions
Replace abstract advice with concrete, executable examples: include actual HTML template markup, schema JSON-LD snippets, example URL patterns with code for generating them, and sample data structures for populating templates.
Cut at least 50% of the content by removing SEO concepts Claude already knows (thin content definitions, keyword stuffing warnings, subfolder vs subdomain advice) and focus only on decision frameworks and implementation specifics unique to this workflow.
Add validation feedback loops to the quality checks section—e.g., specific commands or scripts to check for duplicate titles, thin content detection thresholds, and what corrective actions to take when issues are found.
Either provide the referenced 'references/playbooks.md' bundle file or inline the most critical playbook implementation details; currently the reference points to nothing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is very verbose and explains many concepts Claude already knows well (SEO principles, what thin content is, what keyword stuffing means, basic URL structure advice). The 12 playbooks table, choosing your playbook table, common mistakes, and core principles sections largely restate SEO knowledge Claude already possesses. Much of this could be cut by 60%+ without losing actionable value. | 1 / 3 |
Actionability | Despite its length, the skill provides almost no concrete, executable guidance. There are no code examples, no template code, no specific commands, no actual page template markup, no schema markup examples, and no data pipeline examples. Everything remains at the level of abstract advice ('Identify data sources,' 'Ensure uniqueness') rather than copy-paste-ready implementations. | 1 / 3 |
Workflow Clarity | There is a reasonable sequence (Initial Assessment → Keyword Research → Data → Template Design → Internal Linking → Indexation → Quality Checks → Post-Launch Monitoring) with a pre-launch checklist. However, there are no explicit validation checkpoints with feedback loops—the checklist is static rather than iterative, and there's no guidance on what to do when checks fail or how to verify quality programmatically. | 2 / 3 |
Progressive Disclosure | The skill references 'references/playbooks.md' for detailed playbook implementation, which is good progressive disclosure. However, no bundle files exist to support this reference, and the main file itself is monolithic with ~200 lines of content that could be split (e.g., the 12 playbooks overview, quality checks, and implementation framework could each be separate reference files). Related skills are mentioned but the overall structure is still too heavy for the main file. | 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 | |
3974caa
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.