CtrlK
BlogDocsLog inGet started
Tessl Logo

keyword-clustering

Cluster keywords by intent and map them to existing or proposed pages.

64

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/keyword-clustering/SKILL.md

The canonical home for this skill is keyword-clustering in every-app/open-seo

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, lean skill body: concrete tool usage with exact parameters, a well-sequenced workflow with explicit validation and confirmation checkpoints, and guardrails for edge cases. The only meaningful improvements are trimming the repeated Search Console guidance and possibly moving the detailed output template into a reference file.

DimensionReasoningScore

Conciseness

The body is efficient and operational throughout — no explanations of concepts Claude already knows, dense with tool names, exact parameters, and guardrails. Minor trimmable redundancy (the `dimensions: ["query","page"]` Search Console guidance is repeated three times: in the tools list, workflow step 1, and step 6) keeps it below the 'every token earns its place' anchor of 5, while it is clearly above the 'mostly efficient with some unnecessary explanation' midpoint.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance for an instruction-only skill: exact tool calls with exact parameter values (`dimensions: ["query","page"]`), a concrete write-back snippet (`{ appendResearchLog: { summary: "..." } }`, `addKeyPages`), a defined output template with ordered sections, and conditional fallbacks for each starting point. This matches the 'fully executable; specific examples cover the common cases' anchor.

5 / 5

Workflow Clarity

The seven-step workflow is clearly sequenced with explicit validation checkpoints: reusing the research log before spending credits, a `get_serp_results` overlap check for borderline terms, confirming cannibalization from real Search Console data, and asking before batch-applying tags with `save_keywords` (a confirmation feedback loop for the batch operation, satisfying the batch-cap rule). It is not a 4 because the checkpoints are explicit and data-driven rather than implicit or partially present.

5 / 5

Progressive Disclosure

Good structure with well-labeled sections and clearly signaled cross-references to the `seo-report` and `seo-project-setup` skills (one level deep, no buried references). With no bundle files and ~78 lines of body, everything is appropriately placed except that the detailed output-format section (six subsections) and some repeated Search Console guidance could be deferred to a reference file — a minor organization gap matching the 'good structure; minor organization gaps' anchor rather than the fully split structure of 5.

4 / 5

Total

18

/

20

Passed

Description

61%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 concise, concrete description that clearly states what the skill does, held back mainly by the complete absence of 'when to use it' trigger guidance. Adding a 'Use when...' clause with natural trigger phrases would lift both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to group keywords, build a keyword-to-page map, or decide which page should target a set of keywords.'

Include natural synonyms and phrasing users actually say — 'keyword clustering', 'keyword mapping', 'group keywords', 'SEO' — to broaden trigger coverage.

Optionally surface one or two more distinctive capabilities (e.g., detecting cannibalization or producing page briefs) to sharpen distinctiveness from generic keyword-research skills.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — "Cluster keywords by intent" and "map them to existing or proposed pages" — matching the '1-2 concrete actions, but not comprehensive' anchor. It is not a 4 because coverage stops at two actions (no mention of report generation, cannibalization detection, or tagging), and not a 2 because the actions given are specific rather than generic.

3 / 5

Completeness

The 'what' is clear (cluster keywords by intent, map to pages) but there is no 'Use when...' clause or equivalent explicit trigger guidance; the guideline caps completeness at 3 in that case. It is above 2 because 'what' is concrete, and below 4 because 'when' is entirely absent rather than weakly implied.

3 / 5

Trigger Term Quality

It uses natural phrases users would say — "cluster keywords", "map them to... pages" — giving good keyword coverage. Missing common variations and synonyms like "keyword research", "group keywords", "SEO", or "keyword mapping", which keeps it below the comprehensive-synonym anchor of 5 but above the 'some relevant keywords but missing variations' midpoint.

4 / 5

Distinctiveness Conflict Risk

The intent-and-page-mapping framing carves a fairly clear niche with distinct triggers, with only minor overlap risk against closely related SEO skills (e.g., general keyword research) — matching the 'mostly distinct' anchor. It is not 5 because the description does not anchor to SEO explicitly, leaving slight ambiguity with generic data-clustering phrasing.

4 / 5

Total

14

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
every-app/open-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.