CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

seo-cluster

Cluster keywords by SERP overlap and design hub-and-spoke content architecture with internal links. Use for planning; `/seo cluster execute` then writes the posts with claude-blog's blog-write skill when it is installed, or content briefs when it is not.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

A strong, dense skill body: every step carries concrete thresholds, commands, or schemas, and the workflow is validated with feedback loops and a post-execution scorecard. The two real weaknesses are repetition of DataForSEO guidance in three places and a referenced template file (templates/cluster-map.html) that is missing from the bundle.

Suggestions

Add templates/cluster-map.html to the bundle (or inline its CLUSTER_DATA placeholder structure) so Step 6's 'read the template file' instruction is executable.

Consolidate the DataForSEO cost-check guidance — stated in Step 2, the Error Handling table, and Security — into a single location.

Trim the opening paragraph, which restates the frontmatter description without adding new instruction.

DimensionReasoningScore

Conciseness

Dense, mostly-earned content: threshold tables, exact commands, and JSON schemas with no explanation of concepts Claude already knows. Minor trimming opportunities remain — the opening paragraph restates the frontmatter description, and DataForSEO cost-check guidance is repeated across Step 2, the Error Handling table, and Security.

4 / 5

Actionability

Nearly fully executable: exact overlap thresholds, concrete commands ('"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check ...'), a link-matrix JSON schema, and a precise XSS-escape instruction ('write every < as \u003c'). The gap is Step 6's instruction to read 'templates/cluster-map.html', a file not present in the bundle.

4 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints (dedup with a second expansion pass, cannibalization check, DataForSEO cost approval gate, resume-state scan) and genuine feedback loops for error recovery ('Retry after 30s; if persistent, use intent-only clustering with warning'), capped by a metric-based Cluster Scorecard checklist.

5 / 5

Progressive Disclosure

The body keeps itself an overview, signaling three one-level-deep references ('Load references/serp-overlap-methodology.md for the full algorithm', etc.) at exactly the right workflow points, and all three files exist with substantive content. The dangling 'templates/cluster-map.html' reference — no templates/ directory in the bundle — is a minor navigation gap that keeps it below anchor 5.

4 / 5

Total

17

/

20

Passed

Description

75%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.

A specific, method-anchored description with explicit 'Use for planning' trigger guidance and concrete action verbs. Main weakness is a vague 'when' clause that names no concrete trigger phrases, plus some unmentioned capabilities (visualization, scorecard) and missing common synonyms like 'topic clusters'.

Suggestions

Replace 'Use for planning' with concrete trigger phrases, e.g. 'Use when the user wants to group keywords into topic clusters, plan a hub-and-spoke content structure, or build internal link plans for a site.'

Add natural synonyms such as 'topic clusters', 'keyword research', or 'content strategy' so the description matches how users actually phrase the need.

Mention the interactive cluster map visualization output, since it is a distinctive capability of the skill.

DimensionReasoningScore

Specificity

Lists several concrete actions tied to a specific method — 'Cluster keywords by SERP overlap', 'design hub-and-spoke content architecture with internal links', 'writes the posts ... or content briefs' — but omits capabilities like the interactive cluster map and scorecard, so coverage is not comprehensive.

4 / 5

Completeness

A clear 'what' is paired with an explicit trigger clause ('Use for planning'), but the 'when' is thin — it names no concrete user situations or trigger phrases, so it falls short of the fully explicit anchor 5 while exceeding anchor 3 because the 'Use for...' guidance is present, not implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage ('keywords', 'SERP', 'hub-and-spoke', 'internal links', 'content briefs', 'planning'), but common user phrasings like 'keyword research', 'topic clusters', or 'content strategy' are missing.

4 / 5

Distinctiveness Conflict Risk

SERP-overlap clustering plus hub-and-spoke architecture is a clear niche with method-specific triggers, but it overlaps with generic keyword-research and content-planning skills, leaving minor conflict risk with closely related skills.

4 / 5

Total

16

/

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

AgriciDaniel/claude-seo

Path

skills/seo-cluster/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.