CtrlK
BlogDocsLog inGet started
Tessl Logo

programmatic-seo

Design and evaluate programmatic SEO strategies for creating SEO-driven pages at scale using templates and structured data.

50

Quality

55%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/programmatic-seo/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a solid strategic framework for programmatic SEO evaluation with a well-designed feasibility scoring system and clear phased workflow. Its main weaknesses are the lack of concrete examples (no sample keyword patterns, template mockups, or worked-through feasibility calculations) and moderate verbosity in areas where principles are stated rather than demonstrated. The 12 playbooks listed without elaboration represent wasted tokens that could either be removed or expanded into a referenced file.

Suggestions

Add a worked example showing a complete feasibility index calculation for a real-world scenario (e.g., '[city] + [service] pages') with scores and rationale for each category.

Either remove the 12 playbooks list or expand each with a 1-2 line description and link to a separate PLAYBOOKS.md file with concrete guidance for each pattern.

Add a concrete template specification example showing actual URL patterns, data model fields, and conditional logic rather than just listing these as abstract requirements.

Trim redundant principle statements that Claude can infer (e.g., 'Scaling pages does not lower the bar for quality') to improve token efficiency.

DimensionReasoningScore

Conciseness

The skill contains useful domain-specific frameworks (feasibility index, playbooks, quality gates) that Claude wouldn't inherently know, but there's notable verbosity: repeated emphasis on principles Claude could infer (e.g., 'Scaling pages does not lower the bar for quality'), redundant formatting with excessive horizontal rules, and the 12 playbooks are listed without any actionable detail, wasting tokens on a bare list.

3 / 5

Actionability

The feasibility scoring framework with weights and bands is concrete and usable, and the output format provides a clear deliverable structure. However, there is no executable code, no concrete examples of keyword patterns or template specifications, and the 12 playbooks are named without any guidance on how to apply them. The phase descriptions are more like checklists of topics than actionable instructions.

3 / 5

Workflow Clarity

The phased structure (Phase 0 → 1 → 2 → 3) is well-sequenced with a clear gate at Phase 0 (score ≥ 65 to proceed) and a kill switch for rollback. The pre-index checklist and kill switch criteria serve as validation checkpoints. Minor gap: the transition between phases 2 and 3 lacks explicit validation, and the kill switch criteria could be more specific about thresholds.

4 / 5

Progressive Disclosure

The content is structured with clear sections and headers, but it's a long monolithic file (~200+ lines) with no bundle files to offload detail into. The 12 playbooks, the detailed scoring categories, and the template specification guidance could all benefit from being split into referenced files. The 'Related Skills' section references other skills but doesn't link to supporting detail files for this skill's own content.

3 / 5

Total

13

/

20

Passed

Description

53%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description identifies a clear niche (programmatic SEO at scale) but lacks explicit trigger guidance ('Use when...') and could be more specific about the concrete actions it performs. It would benefit from listing more specific capabilities and including natural user phrases that would trigger skill selection.

Suggestions

Add a 'Use when...' clause with trigger terms like 'programmatic SEO', 'pSEO', 'auto-generated pages', 'bulk landing pages', 'template-based content at scale'.

List more specific actions such as 'generate page templates', 'map data sources to URL structures', 'evaluate keyword patterns', 'audit internal linking for scaled pages'.

Include synonyms and variations users might naturally say, such as 'database-driven pages', 'automated content generation', or 'landing page factories'.

DimensionReasoningScore

Specificity

Names the domain (programmatic SEO) and mentions a couple of concrete aspects (templates, structured data), but doesn't list specific actions like 'generate page templates', 'audit keyword coverage', or 'analyze search performance'.

3 / 5

Completeness

Provides a clear 'what' (design and evaluate programmatic SEO strategies) but has no explicit 'when' clause or trigger guidance for when Claude should select this skill.

3 / 5

Trigger Term Quality

Includes 'programmatic SEO', 'templates', 'structured data', and 'SEO-driven pages at scale', but misses natural user phrases like 'pSEO', 'auto-generated pages', 'landing page generation', 'bulk pages', or 'database-driven content'.

3 / 5

Distinctiveness Conflict Risk

The focus on 'programmatic SEO' and 'pages at scale' is fairly distinctive and unlikely to overlap with general SEO skills or general content creation skills, though there could be minor overlap with broader SEO or content strategy skills.

4 / 5

Total

13

/

20

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
administrakt0r/AI-Agents-Safe-Coding-Skills
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.