CtrlK
BlogDocsLog inGet started
Tessl Logo

keyword-research

Discover keyword opportunities, evaluate metrics and SERPs, and save/tag promising terms.

62

Quality

78%

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-research/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 dense, highly actionable instruction-only skill: concrete tool parameters, confirmation gates, a clear 10-step workflow, and a fully specified output format, with no wasted concept explanations. The only real weaknesses are two near-duplicated passages between the tool section and the workflow, and the absence of error-recovery guidance in the workflow.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no re-teaching of concepts Claude already knows — every line carries project-specific facts (tool names, parameter values, conventions). It stops short of anchor 5 because two passages are near-verbatim duplicates: the striking-distance parameter spec (minPosition: 5, maxPosition: 20, minImpressions: 50) and the local-SEO guidance each appear in both the tool section and the workflow. This is more than anchor 4's 'minor instances', but well below anchor 3's padded feel — the duplication is a tightening opportunity, not verbosity.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact tool names with concrete parameters (150 results, 1-5 seeds, up to 700 keywords), a copy-paste-ready appendResearchLog call shape, explicit output sections in order, and tag conventions (topic:<topic>, intent:<intent>). Specific paths cover the common cases (Search Console connected, local SEO, domain-provided), matching anchor 5; it is not anchor 4 because there are no material gaps in what to run or produce.

5 / 5

Workflow Clarity

The 10-step sequence is clearly ordered with real checkpoints: check the research log before spending credits, ask before saving keywords (reinforced by the guardrail), and stop before writing HTML if seo-report is unavailable. It falls short of anchor 5 because there are no error-recovery feedback loops (e.g., what to do when a tool returns empty results or ambiguous metrics) and no verification step on the finished report; it clearly exceeds anchor 3, whose sequence lacks checkpoints.

4 / 5

Progressive Disclosure

Sections are well-organized and everything lives appropriately in one file — there are no bundle files (references/, scripts/, assets/ are absent) and no nested references to chase. It does not reach anchor 5 because the body runs ~84 lines, above the under-50-line threshold where organized sections alone earn a 5, and the OpenSEO MCP tool reference section (~10 lines) could plausibly live in a separate reference file. It comfortably exceeds anchor 3, since nothing is buried or inlined that clearly belongs elsewhere.

4 / 5

Total

17

/

20

Passed

Description

62%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 is specific and clearly delineates the keyword-research niche, but it is incomplete: it says what the skill does without any guidance on when to invoke it, and it omits the most natural trigger phrases ("keyword research", "SEO", "search volume"). Adding a "Use when..." clause with those terms would lift both completeness and trigger-term quality.

Suggestions

Add a 'Use when...' clause naming the concrete triggering scenarios, e.g., 'Use when the user asks for keyword research, keyword ideas, search volume or SERP analysis, or wants to find/save keywords to target.'

Include the natural trigger phrases users actually say — 'keyword research', 'SEO keywords', 'search volume', 'keyword difficulty' — instead of the generic 'metrics'.

Spell out which metrics are evaluated (e.g., search volume, keyword difficulty, intent, CPC) to close the specificity gap.

DimensionReasoningScore

Specificity

"Discover keyword opportunities", "evaluate metrics and SERPs", and "save/tag promising terms" are three concrete, distinct actions in the keyword-research domain. It falls short of anchor 5 because "metrics" is left unspecified (e.g., search volume, keyword difficulty, intent), leaving minor gaps in coverage; it exceeds anchor 3 because it lists several specific actions, not just 1-2.

4 / 5

Completeness

The "what" is clear (discover opportunities, evaluate metrics/SERPs, save and tag terms), but there is no "Use when..." clause or any equivalent trigger guidance, so "when" is entirely missing. Per the rubric guideline, a missing explicit trigger clause caps completeness at 3, matching the anchor "clear what, when missing or only weakly implied".

3 / 5

Trigger Term Quality

"keyword opportunities" and "SERPs" are natural terms, but the description misses the most common phrasings users would actually say: "keyword research", "SEO", "search volume", or "keyword difficulty". This matches anchor 3 (some relevant keywords, missing common variations/synonyms) rather than anchor 4, which requires good coverage with only a few terms missing.

3 / 5

Distinctiveness Conflict Risk

The vocabulary ("keyword opportunities", "SERPs", "save/tag" keywords) carves out a clear keyword-research/SEO niche that would not naturally trigger competing skills. This matches anchor 5 (clear niche with distinct triggers, minimal conflict risk) — the terms are domain-specific enough that overlap risk is negligible.

5 / 5

Total

15

/

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.