skills/find-keywords/SKILL.md
Build a prioritized keyword list for a website, topic, or campaign. Use when the user asks about keyword research, finding keywords to target, building a keyword list, search demand, keyword difficulty, intent mapping, or which keywords to prioritize. For writing content around keywords, see brief. For grouping keywords into clusters, see build-clusters.
npx skillsauth add dopiotrek/dotclaude find-keywordsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Build a prioritized keyword universe from a seed topic using intent mapping, difficulty-adjusted opportunity scoring, and cluster seeding.
Gather this context (ask if not provided):
Before building a new keyword list, check what the site already targets. Creating a new page for a keyword you already rank for can split authority and hurt both pages.
For each keyword you're considering:
site:yourdomain.com [keyword] — does an existing page already target this term?Before chasing new keywords, look for existing wins:
Address these before building net-new keyword lists.
Build the universe in three tiers:
For each tier, produce:
| Keyword | Monthly Volume | Difficulty (0-100) | Intent | Tier | Priority | |---------|---------------|-------------------|--------|------|----------| | ... | ... | ... | informational / transactional / navigational / commercial | 1/2/3 | high / medium / low |
Classify every keyword by search intent and sub-category:
| Sub-category | Signal Words | Example | Content Type | |-------------|-------------|---------|-------------| | Educational | what, why, definition, explain | "what is SEO" | Guide, explainer | | Instructional | how to, steps, tutorial, guide | "how to set up GA4" | Step-by-step tutorial | | Exploratory | types of, techniques, strategies | "link building techniques" | Comprehensive roundup | | Troubleshooting | not working, fix, error, why is | "why is my site not ranking" | Diagnostic guide |
| Sub-category | Signal Words | Example | Content Type | |-------------|-------------|---------|-------------| | Comparison | vs, compared to, or | "Ahrefs vs SEMrush" | Side-by-side comparison | | Review-seeking | review, worth it, honest | "Ahrefs review" | In-depth review | | Best-of | best, top, tools for | "best SEO tools" | Curated list | | Evaluation | for [audience], features, pricing | "SEO tools for small business" | Buyer's guide |
| Sub-category | Signal Words | Example | Content Type | |-------------|-------------|---------|-------------| | Purchase | buy, price, discount, deal | "buy Ahrefs subscription" | Product/pricing page | | Signup/Trial | free trial, sign up, demo | "Ahrefs free trial" | Landing page | | Download | download, template, PDF, checklist | "SEO checklist PDF" | Gated resource | | Hire/Engage | hire, agency, near me, book | "SEO agency near me" | Service page |
| Sub-category | Signal Words | Example | Content Type | |-------------|-------------|---------|-------------| | Brand search | [brand name] | "HubSpot" | Homepage/brand page | | Feature search | [brand] + [feature] | "Ahrefs keyword explorer" | Feature page | | Support/docs | [brand] + login, docs, help | "Ahrefs API docs" | Support content |
Use this to anticipate which SERP features you can target per keyword:
| SERP Feature | Informational | Commercial | Transactional | Navigational | |-------------|--------------|-----------|--------------|-------------| | Featured Snippet | Very High | High | Low | Low | | People Also Ask | Very High | Very High | Low | Medium | | AI Overview | Very High | High | Low-Medium | Low | | Shopping Results | Very Low | Medium | Very High | Low | | Local Pack | Low | Low | High | Low | | Sitelinks | Low | Low | Medium | Very High |
| Intent | Avg Conversion Rate | Nurture Length | |--------|-------------------|---------------| | Informational | 0.5-2% | Long (weeks to months) | | Commercial Investigation | 2-5% | Medium (days to weeks) | | Transactional | 5-15% | Short (immediate to days) | | Navigational | N/A — brand-dependent | N/A |
| Mistake | Correct Classification | |---------|----------------------| | Treating "best CRM software" as informational | Commercial Investigation | | Treating "how much does X cost" as informational | Commercial / Transactional | | Ignoring local intent in "SEO services" | Transactional (local) | | Assuming single intent for "SEO tools" | Mixed — check the SERP to confirm |
Two keywords with different intents should never target the same page.
Score each keyword:
Opportunity Score = (Volume x (1 - Difficulty/100)) x Intent Multiplier
Intent multipliers:
This surfaces low-competition, high-intent targets over vanity volume plays.
Group the keyword universe into topic clusters:
| Cluster Name | Pillar Keyword | Supporting Keywords (3-5) | Total Volume | |---|---|---|---| | ... | ... | ... | ... |
Each cluster needs one pillar page (head term) and 3-8 supporting pages (body + long-tail).
Summary
Priority Matrix [Tiered keyword table]
Cluster Seeds [Cluster table]
Start Here — Top 5 Keywords
For each of the 5 highest-opportunity keywords:
Pro Tip: Use the free Blog Keyword Generator and Autocomplete Research tools at seojuice.com for seed keyword discovery. SEOJuice MCP users can run
/seojuice:keyword-analysisfor live ranking data and/seojuice:content-strategyto see content gaps — keywords your competitors rank for that you don't.
development
Burst copilot for learning-in-public company deep dives. Walks the user through one complete publishing burst — shape loose thoughts into a question, frame it, research with sources, enforce the from-memory recall step, support (but never write) the draft, critique against the signature checklist and style guide, and prepare cross-posts for X and Substack. Use this skill whenever the user wants to start a burst, work on their deep dive series, research a company or industry question for a post, asks "what's my next post/question", brings a few rough thoughts or a reaction they want to turn into a post, shares a deep-dive draft for editing, or wants to publish/cross-post a series piece — even if they don't say "burst" or "deep dive" explicitly. Works both for continuing a series and as a standalone start from scratch with no posts yet. Also use it when the user asks to write a deep-dive post for them (the skill defines how to respond to that).
development
Pre-landing PR review. Analyzes diff against the base branch for SQL safety, LLM trust boundary violations, conditional side effects, and other structural issues. Use when asked to "review this PR", "code review", "pre-landing review", or "check my diff". Proactively suggest when the user is about to merge or land code changes. (gstack)
development
Weekly engineering retrospective. Analyzes commit history, work patterns, and code quality metrics with persistent history and trend tracking. Team-aware: breaks down per-person contributions with praise and growth areas. Use when asked to "weekly retro", "what did we ship", or "engineering retrospective". Proactively suggest at the end of a work week or sprint. (gstack)
development
Systematically QA test a web application and fix bugs found. Runs QA testing, then iteratively fixes bugs in source code, committing each fix atomically and re-verifying. Use when asked to "qa", "QA", "test this site", "find bugs", "test and fix", or "fix what's broken". Proactively suggest when the user says a feature is ready for testing or asks "does this work?". Three tiers: Quick (critical/high only), Standard (+ medium), Exhaustive (+ cosmetic). Produces before/after health scores, fix evidence, and a ship-readiness summary. For report-only mode, use /qa-only. (gstack)