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

83%

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

88%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, well-engineered skill body: the core SERP-overlap workflow is concrete and executable with explicit thresholds, fallbacks, validation checkpoints, and an error-recovery table, while details are correctly delegated to three real one-level-deep reference files. The only notable gaps are minor: a referenced template file missing from the bundle and a couple of sections (Security, FLOW integration) that could be tightened or moved.

DimensionReasoningScore

Conciseness

The body is dense with tables (thresholds, intents, templates, link rules, errors) and assumes domain competence — it does not explain what SEO or SERPs are. Minor trims possible: the Security section and the trailing FLOW Framework Integration paragraph read as padding relative to the core workflow. Matches the 4 anchor (efficient, minor over-explanation) rather than 5 (every token earns its place).

4 / 5

Actionability

Concrete throughout: exact overlap thresholds ("7-10 | Same post | Merge"), executable commands ("`"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check serp_organic_live_advanced --count N`"), JSON schemas for the link matrix and CLUSTER_DATA, word-count targets, file paths, and specific claude-blog install layouts to check. For an instruction-only skill the guidance is fully executable and covers the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Planning is a clearly sequenced 6-step workflow with explicit validation checkpoints: dedup target ("If under 30, run a second expansion pass"), DataForSEO cost-check approval flow with fallback, cannibalization check, resume-state scanning, and a post-execution scorecard. A 10-row error-handling table gives feedback loops for recovery, matching the 5 anchor (explicit validation, feedback loops, checklists).

5 / 5

Progressive Disclosure

Three one-level-deep references (serp-overlap-methodology.md, hub-spoke-architecture.md, execution-workflow.md) are clearly signaled ("Load ... for the full algorithm") and verified to exist as substantive files. Not 5: the referenced `templates/cluster-map.html` does not resolve within the bundle (no templates/ directory exists), and the plugin-root scripts/ note leaves navigation dependent on an external layout.

4 / 5

Total

18

/

20

Passed

Description

71%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 names concrete, distinctive capabilities and a clear niche, but the trigger guidance is weak: "Use for planning" tells the workflow stage rather than when a user needs the skill, and common natural phrases like "SEO", "keyword research", and "topic clusters" are absent. It is a solid, specific description that falls short on explicit invocation conditions.

Suggestions

Add an explicit 'Use when...' clause, e.g. "Use when doing keyword research or planning topic clusters, pillar pages, or blog content architecture" — currently 'Use for planning' only labels a workflow stage and caps completeness at 3.

Include natural trigger synonyms users would actually say: "keyword research", "topic clusters", "SEO content strategy", "pillar pages" — the description currently only has "keywords", "SERP", and "cluster".

Mention the interactive cluster map visualization ("generates interactive cluster map visualizations") as a distinctive capability, which also differentiates it from the sibling seo-plan skill.

DimensionReasoningScore

Specificity

Quotes: "Cluster keywords by SERP overlap", "design hub-and-spoke content architecture with internal links", "writes the posts with claude-blog's blog-write skill", "or content briefs". Multiple specific concrete actions with a named method (SERP overlap) matching the comprehensive anchor, not the 4 anchor which expects minor coverage gaps.

5 / 5

Completeness

The "what" is clear ("Cluster keywords by SERP overlap and design hub-and-spoke content architecture"), but the only "when" is "Use for planning" — a workflow-stage label, not a trigger condition. Per the guideline that a missing 'Use when...' clause or equivalent explicit trigger guidance caps completeness at 3; it is not a 4 because the when is weakly implied rather than explicit.

3 / 5

Trigger Term Quality

Quotes: "keywords", "SERP", "cluster", "internal links", "content briefs". Good keyword coverage, but natural phrases users would actually say are missing: "SEO", "keyword research", "topic clusters", "pillar pages". Matches the 4 anchor (a few natural terms missing) rather than 5 (comprehensive synonyms/extensions).

4 / 5

Distinctiveness Conflict Risk

Quotes: "SERP overlap", "hub-and-spoke content architecture", "internal links" — a clear niche unlikely to fire for unrelated skills. Not 5 because of minor overlap risk with the sibling `seo-plan` skill (strategy/content planning) and reliance on slash-command invocation rather than distinct natural-language triggers.

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.