keyword-research

Discover, analyze, and prioritize keywords for SEO and GEO content strategies from a seed keyword or niche. Identifies high-value opportunities based on search volume, competition, intent, and business relevance. Generates topic clusters. For building a dated editorial calendar from your own Search Console data, use `content-planner` instead — this skill is seed-driven keyword discovery, not calendar scheduling. Use when asked to "find keywords", "keyword research", "keyword analysis", "search volume", "keyword difficulty", "content ideas from a seed", or any keyword discovery task.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./seo/keyword-research/SKILL.md

Quality

Content

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

The content is well-structured and actionable with clear references to real bundle files, but it is noticeably verbose — it restates the description and inlines template blocks and concept explanations that duplicate the reference files and that Claude already knows.

Suggestions

Remove the restated overview paragraph and the motivational 'Tips for Success' list; the frontmatter description and the numbered workflow already convey this, so these tokens compete with context for no new information.

Move the inlined template blocks (keyword expansion patterns, difficulty factor bands, opportunity matrix, topic cluster template) into the existing reference files and replace them with one-line pointers, keeping only the core formulas and intent table inline.

Tighten the 'When This Must Trigger' section: the two consecutive lead sentences ('Use this when the conversation involves...' and 'Use this whenever the task needs reusable market intelligence...') are redundant with the description's trigger clause.

Dimension	Reasoning	Score
Conciseness	Noticeably verbose: the body restates the description, inlines large template-style markdown blocks (keyword expansion patterns, difficulty factors, opportunity matrix, cluster templates) that duplicate the dedicated reference files, and pads with motivational "Tips for Success" and concept-level explanations Claude already knows.	2 / 5
Actionability	Provides concrete executable guidance — the Opportunity formula `Opportunity = (Volume × Intent Value) / Difficulty`, an intent classification table, difficulty bands, and a report structure — though many artifacts are template placeholders rather than copy-paste-ready commands.	4 / 5
Workflow Clarity	A clear 9-step sequence (Understand Context → Generate Output Report) is present, with a dedicated Validation Checkpoints section covering input and output validation; minor gaps are that checkpoints are listed separately rather than inline at each step.	4 / 5
Progressive Disclosure	Good structure with four real, one-level-deep reference files clearly linked in a Reference Materials section (intent taxonomy, cluster templates, prioritization framework, example report), though several of those topics are also inlined in the body rather than fully offloaded.	4 / 5
	Total	14 / 20 Passed

Description

96%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, specific description that answers both what and when with comprehensive trigger phrases and explicit boundary guidance against a sibling skill. The only soft spot is a slight overlap risk from the content-calendar trigger, which is otherwise well disambiguated.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "Discover, analyze, and prioritize keywords", "Identifies high-value opportunities based on search volume, competition, intent, and business relevance", "Generates topic clusters" — covering the full workflow comprehensively.	5 / 5
Completeness	Clearly states what the skill does and gives an explicit "Use when..." clause with concrete trigger phrases, fully answering both what and when.	5 / 5
Trigger Term Quality	Explicitly enumerates natural phrases users would say — "find keywords", "keyword research", "keyword analysis", "search volume", "keyword difficulty", "content ideas from a seed" — with strong synonym coverage.	5 / 5
Distinctiveness Conflict Risk	Has a clear niche with explicit disambiguation against content-planner ("use content-planner instead — this skill is seed-driven keyword discovery"), though "Planning content calendars" as a trigger introduces minor overlap risk with calendar/content skills.	4 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 1 suspicious	Warning

	Total	14 / 16 Passed

Repository: nowork-studio/NotFair
Path: seo/keyword-research/SKILL.md
Commit: 8d9d54b

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.