CtrlK
BlogDocsLog inGet started
Tessl Logo

programmatic-seo

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," "building many pages for SEO," "pSEO," "generate 100 pages," "data-driven pages," or "templated landing pages." Use this whenever someone wants to create many similar pages targeting different keywords or locations. For auditing existing SEO issues, see seo-audit. For content strategy planning, see content-strategy.

56

Quality

62%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/programmatic-seo/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 clear completeness, explicitly answering both what and when. The cross-references to related skills (seo-audit, content-strategy) are a notable strength for disambiguation. The main weakness is that the 'what' portion could be more specific about the concrete actions the skill performs beyond just 'creating pages at scale.'

Suggestions

Add 2-3 more specific concrete actions to the capability description, e.g., 'Generates page templates, maps CSV/database data to URL patterns, creates meta tags and structured content for each page variant.'

DimensionReasoningScore

Specificity

The description names the domain (SEO-driven pages at scale using templates and data) and mentions some actions like creating pages, but doesn't list multiple specific concrete actions (e.g., generate templates, map data to pages, configure URL structures, etc.). The 'what' is more of a general capability statement than a list of concrete actions.

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 helpful boundary-setting by referencing related skills (seo-audit, content-strategy) for disambiguation.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including 'programmatic SEO,' 'pSEO,' 'template pages,' 'pages at scale,' 'directory pages,' 'location pages,' '[keyword] + [city] pages,' 'comparison pages,' 'integration pages,' 'generate 100 pages,' 'data-driven pages,' and 'templated landing pages.' These are highly natural terms users would actually say.

3 / 3

Distinctiveness Conflict Risk

The description carves out a very clear niche (programmatic SEO / templated pages at scale) and explicitly differentiates itself from related skills like seo-audit and content-strategy, significantly reducing conflict risk.

3 / 3

Total

11

/

12

Passed

Implementation

35%

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 comprehensive SEO guide than a targeted instruction set for Claude. It over-explains foundational SEO concepts Claude already knows while under-delivering on concrete, executable artifacts like template code, data schemas, or generation scripts. The structure is reasonable but the content-to-signal ratio is low, and the referenced bundle file (playbooks.md) doesn't exist.

Suggestions

Cut core principles and common mistakes sections significantly—Claude knows basic SEO rules. Replace with a brief 'constraints' list of 2-3 lines.

Add concrete, executable examples: a sample page template (HTML/JSX), a data schema (JSON), and a script or pseudocode for generating pages from data + template.

Add explicit validation steps with feedback loops, e.g., 'After generating pages, check for duplicate title tags by running X; if duplicates found, adjust the title template pattern.'

Either provide the referenced 'references/playbooks.md' bundle file or inline the most critical playbook implementation details and remove the dead reference.

DimensionReasoningScore

Conciseness

The skill is very verbose, explaining many concepts Claude already knows (what programmatic SEO is, what thin content means, basic SEO principles like 'no keyword stuffing'). 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 50%+ without losing actionable value.

1 / 3

Actionability

The skill provides structured frameworks and checklists but lacks concrete, executable examples—no actual template code, no sample data structures, no specific commands or scripts for generating pages. The implementation framework describes what to do at a high level but doesn't show how with copy-paste ready artifacts.

2 / 3

Workflow Clarity

There is a clear sequence (research → data → template → linking → indexation) with pre/post-launch checklists, but validation checkpoints are weak—the checklists are static checkboxes rather than explicit validation steps with feedback loops. There's no 'if this fails, do X' recovery guidance for critical steps like indexation or thin content detection.

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 a monolithic wall of content (~200 lines) that could benefit from splitting sections like quality checks, implementation framework, and the playbook details into separate referenced files.

2 / 3

Total

7

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
coreyhaines31/marketingskills
Reviewed

Table of Contents

Is this your skill?

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.