CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-cluster

Cluster keywords by SERP overlap and design hub-and-spoke content architecture with internal links. Use for planning only; use the blog-cluster command to execute article production.

68

Quality

86%

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

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

An exemplary instruction-style skill body: concrete thresholds, schemas, commands, and error resolutions with well-signaled one-level-deep references verified to exist and be substantive. The only real improvement is trimming the small amount of cross-promotional and repeated content.

DimensionReasoningScore

Conciseness

The body is predominantly lean, table-driven, and assumes Claude's competence (threshold tables, exact counts, JSON schemas, no concept explanations). Not 5 because a few tokens don't earn their place: the 'FLOW Framework Integration' section reads as cross-skill promotion, and the DataForSEO cost-check flow is described three times (Step 2, Error Handling, Security). Well above anchor 3, which requires noticeable unnecessary explanation.

4 / 5

Actionability

Fully executable guidance throughout: exact commands ('/seo cluster plan <seed-keyword>'), numeric thresholds (7-10/4-6/2-3/0-1 shared results with prescribed actions), a JSON link-matrix schema with example entries, concrete CLUSTER_DATA structure, exact script invocations ('${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo' run dataforseo_costs.py ... '), glob patterns for strategy import, and per-error resolutions. Common cases (plan, execute with/without claude-blog, map regeneration, strategy import) are all covered concretely.

5 / 5

Workflow Clarity

The six planning steps are clearly sequenced with explicit validation checkpoints (cannibalization check in Step 4, data validation in strategy import, post-execution scorecard) and genuine feedback loops for a batch content operation: 'If under 30, run a second expansion pass', 'Retry after 30s; if persistent, use intent-only clustering', WebSearch fallback on DataForSEO 'blocked', and resume-state rebuild from output directory scan. The scorecard table doubles as a checklist for complex processes.

5 / 5

Progressive Disclosure

Verified against the actual bundle: all three referenced files exist in references/ (serp-overlap-methodology.md, hub-spoke-architecture.md, execution-workflow.md), are substantive (108-181 lines of real detail), and are one level deep with no further nested references. The body keeps overview-level content (thresholds, command surface, error table) inline and clearly signals 'Load references/... for the full algorithm' at exactly the right points, splitting content appropriately between overview and detail.

5 / 5

Total

19

/

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 solid description with concrete capabilities and an unusually good scope boundary distinguishing planning from execution. Its main weakness is the absence of a natural 'Use when...' trigger clause with concrete user-facing trigger phrases, and a missed opportunity to include common synonyms like 'topic clusters' or 'keyword research'.

Suggestions

Add a concrete trigger clause, e.g. 'Use when the user wants to group keywords into topic clusters, plan internal linking, or build a content architecture around a seed keyword.'

Include common synonyms users would naturally say -- 'topic clusters', 'keyword research', 'content strategy' -- alongside the existing SERP-overlap and hub-and-spoke terminology.

DimensionReasoningScore

Specificity

Lists several specific concrete actions -- 'Cluster keywords by SERP overlap', 'design hub-and-spoke content architecture', 'with internal links' -- each tied to a concrete method (SERP overlap as the clustering signal). Falls short of 5 because coverage is not comprehensive: visualization, strategy import, and post-execution scorecard capabilities from the body are unmentioned; exceeds 3 because it goes beyond 1-2 generic actions with a distinctive mechanism.

4 / 5

Completeness

The 'what' is clearly answered (SERP-overlap keyword clustering, hub-and-spoke architecture design, internal links). A 'when' is present via 'Use for planning only; use the blog-cluster command to execute article production', which is explicit scope guidance but not a concrete user-trigger phrase, so it does not reach anchor 5's 'concrete trigger phrases'; it is more than weakly implied, so it exceeds anchor 3.

4 / 5

Trigger Term Quality

Contains natural phrases SEO practitioners would say: 'cluster keywords', 'internal links', 'content architecture', 'hub-and-spoke'. Not 5 because common synonyms and variations are missing -- 'topic clusters', 'keyword research', 'content strategy' are absent; 'SERP overlap' leans technical. Better than 3, which would only have a few relevant keywords with most common variations missing.

4 / 5

Distinctiveness Conflict Risk

Keyword clustering by SERP overlap is a clear niche, and the explicit planning-vs-execution boundary ('Use for planning only; use the blog-cluster command to execute') actively disambiguates. Not 5 because the description shares SEO keyword territory with closely related sibling skills (seo-plan, seo-content, seo-dataforseo) listed in the body's cross-skill table, leaving minor overlap risk.

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