CtrlK
BlogDocsLog inGet started
Tessl Logo

programmatic-seo

How to design and run a programmatic SEO program that produces durable traffic instead of penalty-bait. Data source identification, template design, schema patterns, quality control at scale, internal linking architecture, crawl budget management, AEO/GEO for programmatic pages, refresh discipline, and the make-or-break question of whether pSEO is the right answer for your program at all. Triggers on programmatic SEO, pSEO, scaled content, page generation, template SEO, location pages, comparison pages, directory site, listing site, scaled landing pages, programmatic content. Also triggers when a content set is not ranking, has been hit by an algorithm update, or when a team is considering pSEO as a growth lever.

60

Quality

71%

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

100%

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 that thoroughly covers specific capabilities, provides extensive natural trigger terms, and clearly delineates both what the skill does and when it should be used. The description is well-structured with a clear niche that minimizes conflict risk with other skills. The only minor issue is the use of second person 'your' in two places, though this is relatively minor given the overall quality.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: data source identification, template design, schema patterns, quality control at scale, internal linking architecture, crawl budget management, AEO/GEO for programmatic pages, refresh discipline, and evaluating whether pSEO is appropriate.

3 / 3

Completeness

Clearly answers both 'what' (design and run programmatic SEO programs with specific sub-capabilities listed) and 'when' (explicit trigger terms listed with 'Triggers on...' and 'Also triggers when...' clauses covering both keyword and situational triggers).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'programmatic SEO', 'pSEO', 'scaled content', 'page generation', 'template SEO', 'location pages', 'comparison pages', 'directory site', 'listing site', 'scaled landing pages', plus situational triggers like 'hit by an algorithm update' and 'considering pSEO as a growth lever'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche focused specifically on programmatic SEO, which is clearly distinguishable from general SEO, content strategy, or web development skills. The specific triggers like 'pSEO', 'template SEO', 'location pages', and 'directory site' are unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

42%

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

This is a comprehensive strategic playbook for programmatic SEO with excellent organization and progressive disclosure, but it suffers significantly from verbosity and lack of concrete, executable artifacts. The content repeatedly explains concepts and motivations that Claude already understands, and while it provides good strategic heuristics (specific numbers, thresholds, decision criteria), it never delivers actual code, templates, schema examples, or executable commands that would make it truly actionable.

Suggestions

Cut 40-50% of the content by removing motivational framing, repeated thesis statements about quality-at-scale, and explanations of concepts Claude already knows (e.g., what first-party data is, what internal linking means). Trust Claude's intelligence.

Add at least one concrete, executable artifact: a sample JSON-LD schema template, a sample pSEO design document skeleton, or a sample automated quality check script that demonstrates the principles described.

Convert the implicit workflow into an explicit numbered sequence with validation gates: e.g., 'Step 1: Run decision framework → Step 2: Document data source → Step 3: Design schema (validate: 15+ fields?) → Step 4: Build template (validate: random sample test) → ...' with clear pass/fail criteria at each gate.

Remove redundant sections—the 12-consideration framework largely restates what was already covered in the preceding sections. Either use the framework as the primary structure and cut the verbose sections, or keep the sections and remove the framework summary.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~3000+ words. It repeatedly explains concepts Claude already understands (what pSEO is, what data sources are, what internal linking means), restates the same quality-at-scale thesis multiple times, and includes extensive motivational framing ('the reputation problem is not pSEO; it is pSEO without underlying value') that adds no actionable value. The closing section rehashes points already made. Many sections could be cut by 50-70% without losing information.

1 / 3

Actionability

The skill provides specific, opinionated guidance with concrete numbers (50-200 pages per audit, 5% failure threshold, 15+ fields per record, top-200-word answer) and clear decision criteria. However, it lacks any executable code, commands, scripts, or concrete templates. Everything remains at the strategic/conceptual level—there are no actual schema examples, no template code snippets, no sample automated check configurations, and no example pSEO design document structure.

2 / 3

Workflow Clarity

The 12-consideration framework provides a clear checklist, and individual sections describe processes (sampling, template migration, pruning). However, there is no explicit end-to-end workflow with sequenced steps and validation checkpoints. The template migration section mentions 'cohort-by-cohort migration with monitoring' but doesn't specify what to monitor or what constitutes pass/fail. The quality control section has the strongest workflow elements (sample → check → threshold → halt) but lacks explicit feedback loops for recovery.

2 / 3

Progressive Disclosure

The skill has excellent progressive disclosure structure: a clear overview with well-organized sections, each ending with a reference to a detailed file in the references/ directory. References are one level deep, clearly signaled with descriptive labels, and the reference files section at the end provides a complete index. The main document serves as a navigable overview without burying the reader in excessive detail.

3 / 3

Total

8

/

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
rampstackco/claude-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.