CtrlK
BlogDocsLog inGet started
Tessl Logo

keyword-research

Use when the user asks to "find keywords", "keyword research", "what should I write about", "identify ranking opportunities", "topic ideas", "what are people searching for", "which keywords should I target", or "give me keyword ideas". Discovers high-value keywords with search intent analysis, difficulty assessment, and content opportunity mapping. Essential for starting any SEO or GEO content strategy. For analyzing competitor keywords specifically, see competitor-analysis. For content topic gaps, see content-gap-analysis.

64

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/keyword-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

Highly actionable and well-sequenced with strong validation checkpoints and a concrete worked example, but the body is verbose and self-duplicating, inlining material that already exists in its own reference files.

Suggestions

Remove the duplicated "Keyword Intent Taxonomy" and "Topic Cluster Architecture" sections from the body and rely on the existing references, keeping only a one-line pointer plus the essential matrix.

Delete SEO-101 explanatory filler (e.g., "Understanding search intent is critical for keyword selection") that Claude already knows, tightening the body toward the actionable steps and templates.

Add an explicit feedback loop to the workflow (e.g., after output validation fails: revise the cited data source or re-score affected keywords, then re-validate) to lift workflow clarity to the top anchor.

DimensionReasoningScore

Conciseness

The ~580-line body noticeably pads: search intent classification is presented twice (Instructions Step 4 and the later "Keyword Intent Taxonomy" section) and topic-cluster architecture is duplicated (Step 8 and "Topic Cluster Architecture"), plus SEO-101 explanations like "Understanding search intent is critical...".

2 / 5

Actionability

Fully actionable: a concrete opportunity formula (Volume × Intent Value / Difficulty), a weighted Priority Scoring Matrix with explicit factor weights, and a complete worked example populated with real keyword volumes, difficulties, and scores cover the common cases.

5 / 5

Workflow Clarity

A clear 9-step numbered sequence with a dedicated Validation Checkpoints section (input and output checklists), so the batch-operation cap does not apply; the only gap is the absence of an explicit validate→fix→retry error-recovery loop.

4 / 5

Progressive Disclosure

Two real one-level-deep references are clearly signaled in a Reference Materials section, but the intent taxonomy and topic-cluster templates are fully inlined in the body despite having dedicated reference files, duplicating content that should live only in the bundle.

3 / 5

Total

14

/

20

Passed

Description

95%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 strong description that pairs a clear capability statement with abundant natural trigger phrases and explicit boundary guidance against sibling skills. The only weakness is mild abstraction in one of the listed actions.

DimensionReasoningScore

Specificity

Names several concrete actions ("search intent analysis, difficulty assessment, and content opportunity mapping"), but "content opportunity mapping" is somewhat abstract, leaving minor gaps versus a fully comprehensive action list.

4 / 5

Completeness

Explicitly answers both what ("Discovers high-value keywords with...") and when ("Use when the user asks to...") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Eight natural trigger phrases users would actually say ("find keywords", "keyword research", "what should I write about", "what are people searching for", "which keywords should I target", etc.) give comprehensive coverage of natural terms.

5 / 5

Distinctiveness Conflict Risk

Clear SEO/GEO keyword niche with explicit disambiguation ("For analyzing competitor keywords specifically, see competitor-analysis. For content topic gaps, see content-gap-analysis."), minimizing conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (581 lines); consider splitting into references/ and linking

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 27 suspicious

Warning

Total

13

/

16

Passed

Repository
teeclaw/phorm-nft
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.