CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

programmatic-seo

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

Quality

66%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/programmatic-seo/SKILL.md

The canonical home for this skill is programmatic-seo in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

56%Weight 40%Scale 1-5

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

The body presents a well-structured, gated strategy workflow with genuine quality-control checkpoints (feasibility bands, kill switch), but its scoring framework lacks operational detail and worked examples, and it inlines content that belongs in reference files. Redundant headers and a filler 'When to Use' section also cost token efficiency.

Suggestions

Operationalize the Feasibility Index: specify how points are assigned within each category (e.g. point-per-criterion rules or a worked example scoring a real keyword pattern) so the score is reproducible.

Move the 12 playbooks and per-category scoring detail into a references/ file, keeping SKILL.md as an overview, and replace the bare playbook name list with brief selection guidance.

Merge the duplicate Feasibility Index section headers, remove the filler 'When to Use' section (that guidance belongs in the description), and make 'Related Skills' reference actual linked paths or drop it.

DimensionReasoningScore

Conciseness

Mostly lean bullet lists with no explanation of concepts Claude already knows, but there is clear tightening opportunity: the Feasibility Index is split across two near-duplicate section headers ('Phase 0: Programmatic SEO Feasibility Index (Required)' followed by '🔢 Programmatic SEO Feasibility Index'), the 12-playbook section is a bare name list adding little actionable value, and the closing 'When to Use' section is vague filler ('This skill is applicable to execute the workflow or actions described in the overview.').

3 / 5

Actionability

The framework structure is concrete (six weighted categories, score ranges, verdict bands, output format), but the scoring method itself is unoperationalized — e.g. 'Search Pattern Validity (0–20): Clear repeatable keyword pattern, consistent intent, sufficient aggregate demand' gives no rule for assigning points within 0–20, and there is no worked example of a keyword pattern or template specification.

3 / 5

Workflow Clarity

The sequence is clearly gated (Phase 0 feasibility with 'Only proceed if Feasibility Index ≥ 65' and 'If the verdict is Do Not Proceed, stop', then Phases 1–3) with explicit checkpoints (Pre-Index Checklist, Kill Switch Criteria: 'If triggered, halt indexing or roll back'). Not a 5 because there is no explicit re-validate/retry loop after a kill-switch trigger and the phase steps are thin checklists.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the ~340-line body inlines content that could live in separate reference files (the 12 playbooks, per-category scoring guidance). The 'Related Skills' section names other skills without paths or links. Good section headers exist, but content that should be separate is inline, matching anchor 3.

3 / 5

Total

13

/

20

Passed

Description

61%Weight 40%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 clearly communicates a distinct niche and concrete actions, but omits any 'when to use' trigger guidance and misses common synonyms like 'pSEO'. It is a solid, specific description that falls short of the exemplary format.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when the user asks about programmatic SEO, pSEO, or generating SEO pages at scale from templates and structured data.'

Include common synonyms and natural phrasings such as 'pSEO', 'SEO pages at scale', and 'template-based page generation' to broaden trigger term coverage.

Enumerate more of the skill's concrete capabilities (scoring feasibility, indexation control, risk assessment) to close the coverage gap.

DimensionReasoningScore

Specificity

Names the domain ('programmatic SEO') and two concrete actions ('Design and evaluate... strategies for creating SEO-driven pages at scale using templates and structured data'), matching the anchor for domain plus 1-2 concrete actions but not comprehensive coverage of the skill's sub-capabilities.

3 / 5

Completeness

The 'what' is clear (design and evaluate programmatic SEO strategies), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Includes the natural phrases a user would say ('programmatic SEO', 'SEO-driven pages', 'at scale', 'templates', 'structured data'), but misses common synonyms and variations such as 'pSEO' or 'landing pages at scale', fitting the good-but-incomplete anchor rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

'Programmatic SEO' is a clear niche with distinct triggers, but 'structured data' and 'SEO' broadly overlap with closely related skills (schema-markup, seo-audit), giving minor overlap risk rather than minimal.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/programmatic-seo/SKILL.md

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.