keyword-research
by aaron-he-zhu
Coding Agents & IDEsBrief
Use when the user asks to "find keywords", "keyword research", "what should I write about", "identify ranking.
Description
What This Skill Does
Analyzes and prioritizes keywords for SEO and GEO content strategies. Classifies keywords by search intent (informational, navigational, commercial, transactional), scores difficulty and opportunity, and groups them into topic clusters with pillar and cluster page assignments. Works with Ahrefs, SEMrush, Google Keyword Planner, Google Search Console, or manual input.
It combines intent classification, difficulty scoring, GEO opportunity detection, and topic clustering in one structured workflow instead of requiring separate tools for each task.
When to Use It
- Finding low-competition keywords before starting a blog series
- Building a content calendar around a new product launch
- Identifying question-format keywords likely to surface in AI search results
- Researching local search terms for a regional service business
- Spotting keyword gaps before entering a new market
Example Workflow
User asks: Find keywords for a project management software targeting small businesses
- 1
Asks clarifying questions about target audience, business goals, domain authority, and geographic targeting
- 2
Generates seed keywords from core product terms, problem-focused phrases, and audience-specific language
- 3
Expands each seed with modifiers, long-tail variants, and question formats
- 4
Classifies each keyword by intent, scores difficulty on a 1-100 scale, and calculates opportunity scores using volume and intent weight
- 5
Groups keywords into topic clusters with pillar and cluster page assignments and outputs a priority-ranked content calendar
A keyword research report with an executive summary, quick-win and growth opportunity lists, topic clusters mapped to content types, and a content calendar with priority scores
Requirements
- AHREFS_API_KEY (optional, enables automated data pull)
- SEMrush account (optional)
- Google Keyword Planner access (optional)
- Google Search Console access (optional)
Installation
clawhub install aaron-he-zhu/keyword-researchRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.