seo-keyword-selection
Choose the next keywords to target, for a new website from the owner's intake, or for an existing website from measured search demand. Sets a primary and alternate keywords, validates them with RankMySEO or Search Console, checks relevance to the business, and classifies each as money, tool, hub, or informational. Use before a plan is written for a new site, or when the owner asks what to target next on an existing one.
rankmyseo · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add rankmyseo/skills --skill seo-keyword-selectionAbout this skill
name: seo-keyword-selection description: Choose the next keywords to target, for a new website from the owner's intake, or for an existing website from measured search demand. Sets a primary and alternate keywords, validates them with RankMySEO or Search Console, checks relevance to the business, and classifies each as money, tool, hub, or informational. Use before a plan is written for a new site, or when the owner asks what to target next on an existing one.
Keyword selection
Goal: a short list of keywords, each with one owner page type, one reason, and a validation status. Keywords become tracked only after the owner's yes.
Acceptance: the owner can read the list and say which page answers each keyword, and why that keyword fits the business.
Use the evidence that exists. For a new site, the evidence is the owner's words and the research tools. For an existing site, the evidence is what people already search for.
Path A: new website (no search data yet)
- Start from the intake. Use the product, the place, the goal, the competitor, and the customers' own words. This gives a hypothesis, not data. Say so in the plan.
- Choose a primary keyword. It is the phrase a buyer or reader would type for this product in this place. Choose by fit with the business, not by how large it sounds.
- Add alternates. Three to five other phrasings: synonyms, category names, question forms, and the competitor's name when a buyer compares.
- Validate with RankMySEO. Call
keyword_plannerwith each seed (q), the country from the intake, and the savedproject. The keyword tools need a saved site, so ask for the domain and add it withadd_projectafter the owner's yes. Read untilstatusisready. Show volume and difficulty only where they appear. Unknown stays unknown. - Check the competitor. Once the competitor is saved and collected,
keyword_gaplists keywords it ranks for that the site does not. Use it to find gaps, not to copy the competitor's whole list. - Check other platforms. For social platforms the owner uses, use
social_researchafter the draft list exists. Checksocial_lookupsfirst.
Path B: existing website (search data exists)
- Start from what people already search.
search_consolewithdays: 28gives the top queries, with clicks, impressions, CTR, and position. These beat any estimate. - Read the tracked rank.
list_keywordsandkeyword_historyshow the current position and trend for tracked keywords. - Rank the candidates. Keywords that already show impressions and sit at positions 4 to 10 are the closest wins. Positions 11 to 20 need more work. A keyword at position 30 or lower with many impressions usually points to the wrong page or a thin one, not a quick win.
- Read the competitor gap.
keyword_gap(Starter and above) shows keywords rivals rank for that the site does not. - Look at the site's content.
research_sitereturns clusters from the pages the site has. Use it to see what the site already covers. If no website review has run yet, the call starts one, which uses the daily research budget; ask the owner first. - Separate brand queries. Queries that contain the brand name measure brand demand. Keep them in their own group, and do not count them as new keyword targets.
Relevance check (judgment, for both paths)
Keep a keyword only if it:
- describes what the owner sells or publishes,
- fits the country and language the owner serves, and
- can be answered by a page the owner will build or keep.
Drop a keyword when a different kind of page answers it. Show the owner the drop list, with a reason for each drop.
Classify each keyword
Give each kept keyword one type, using the same rules as seo-launch-plan:
- Money: a buyer acts, with words like software, service, agency, or pricing.
- Tool: a free result, with words like checker, tool, or audit.
- Hub: a topic term with no product of its own.
- Informational: a question, with words like what is, how to, or meaning.
If a page already ranks for the keyword or gets impressions for it, that page stays the owner. A new page links to it and does not compete.
Output
A table with these columns: keyword, type, owner page (existing or planned), source (Search Console, RankMySEO planner, competitor gap, or intake), volume and difficulty where available, relevance decision, and tracking status. Mark each keyword as validated, hypothesis, or dropped.
Then ask the owner which keywords to track. Track only the ones they pick, with add_keyword, after their yes.
Do not
- Estimate volume, difficulty, or position.
- Track a keyword before the owner picks it.
- Pick a keyword only because a competitor ranks for it.
- Treat a brand query as a new keyword target.