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," or "building many pages for SEO." For auditing existing SEO issues, see seo-audit.

63

Quality

55%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./config/claude/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 description with excellent trigger term coverage and clear disambiguation from related skills. Its main weakness is that the 'what' portion could be more specific about the concrete actions performed (e.g., generating templates, populating data fields, creating URL structures). The explicit 'when' 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.'

DimensionReasoningScore

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' 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 strategic SEO guide or consulting framework 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, no specific tool commands, no template examples. The structure is reasonable but the content-to-value ratio is low given the token budget consumed.

Suggestions

Replace abstract guidance with concrete, executable examples: provide actual template code (HTML/Next.js/etc.), specific URL patterns, and example schema markup JSON-LD that Claude can directly use or adapt.

Remove sections explaining concepts Claude already knows (Core Principles like 'avoid keyword stuffing', 'no duplicate content', 'quality over quantity') to dramatically reduce token usage.

Add a concrete worked example showing the full workflow: from keyword pattern → data structure → template code → generated page output, so Claude can follow a real implementation path.

Move the 12 playbooks table, choosing matrix, and common mistakes into reference files, keeping only a brief summary with links in the main skill file.

DimensionReasoningScore

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 12 playbooks table and choosing framework add bulk without actionable specifics.

1 / 3

Actionability

The skill contains no executable code, no concrete commands, no specific templates, and no copy-paste ready examples. It reads as a strategic overview/consulting framework rather than actionable instructions. Phrases like 'Identify data sources' and 'Validate demand' describe what to do abstractly without showing how.

1 / 3

Workflow Clarity

There is a clear sequence in the Implementation Framework (5 numbered steps) and pre/post-launch checklists provide validation checkpoints. However, the steps remain abstract without concrete validation mechanisms—there's no feedback loop for fixing issues, and the checklists are generic rather than tied to specific tool outputs or commands.

2 / 3

Progressive Disclosure

There is one reference to a detailed playbook file (references/playbooks.md) and related skills are mentioned at the end. However, the main file contains extensive inline content that could be split out (e.g., the full implementation framework, quality checks, common mistakes), and the overview sections are too detailed for what should be a top-level skill 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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
freekmurze/dotfiles
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.