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.

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

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/programmatic-seo/SKILL.md

The canonical home for this skill is programmatic-seo in coreyhaines31/marketingskills

SKILL.md
Quality
Evals
Security

Quality

Content

20%Scale 1-3

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

This skill reads as a high-level SEO strategy guide rather than an actionable skill for Claude. It is excessively verbose, restating SEO concepts Claude already knows, while providing almost no concrete, executable guidance—no code, no commands, no specific templates, no tool usage. The structure and workflow are reasonable but remain at the strategic/abstract level rather than providing the operational specificity needed for Claude to act on.

Suggestions

Replace abstract descriptions with concrete, executable examples—e.g., provide an actual page template (HTML/JSX), a data schema (JSON), and a script for generating pages from a CSV/database.

Cut at least 50% of the content by removing SEO concepts Claude already knows (thin content definitions, keyword stuffing warnings, basic URL advice) and focus only on novel, project-specific instructions.

Add specific tool/command guidance—e.g., how to generate sitemaps, how to validate page uniqueness programmatically, what scripts to run for quality checks.

Create the referenced 'references/playbooks.md' bundle file with detailed implementation for each playbook, and consider splitting quality checklists and common mistakes into separate reference files.

DimensionReasoningScore

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 contains no executable code, no concrete commands, no specific tool usage, and no copy-paste ready examples. It reads as a strategic overview/consulting framework rather than actionable instructions. The 'Implementation Framework' section describes what to do abstractly but never shows how—no template code, no data pipeline examples, no actual page generation scripts.

1 / 3

Workflow Clarity

There is a reasonable sequence (Initial Assessment → Core Principles → Choose Playbook → Implementation Framework → Quality Checks → Post-Launch Monitoring) with a pre-launch checklist that serves as a validation checkpoint. However, the steps lack specificity—there are no concrete validation commands, no feedback loops for error recovery, and the workflow is more of a strategic outline than an operational procedure.

2 / 3

Progressive Disclosure

The skill references 'references/playbooks.md' for detailed playbook implementation, which is good progressive disclosure. However, no bundle files are provided, so that reference is unverifiable. The main file itself is monolithic with substantial content that could be split into separate reference files (e.g., the 12 playbooks overview, quality checklists, common mistakes). Related skills are mentioned at the end, which is helpful.

2 / 3

Total

6

/

12

Passed

Description

89%Scale 1-3

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 disambiguation from seo-audit is a notable strength. The main weakness is that the 'what' portion could be more specific about the concrete actions the skill performs beyond the high-level 'create SEO-driven pages at scale using templates and data.'

Suggestions

Add more specific concrete actions to the 'what' portion, e.g., 'Generates page templates, populates them with structured data, creates URL patterns, and outputs SEO-optimized HTML pages at scale.'

DimensionReasoningScore

Specificity

The description names the domain (SEO-driven pages at scale) and mentions 'using templates and data,' but doesn't list multiple concrete actions like 'generate template files, populate data fields, create URL structures, build sitemaps.' The actions are somewhat implied rather than explicitly enumerated.

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 note pointing to seo-audit for related but different tasks.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: '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 terms users would naturally use when requesting this type of work.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche (programmatic SEO page generation) and explicit disambiguation from the related seo-audit skill. The specific trigger terms like 'programmatic SEO,' 'location pages,' and '[keyword] + [city] pages' make it very unlikely to conflict with other skills.

3 / 3

Total

11

/

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
TheCraigHewitt/seomachine
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.