keyword-research

Installation
SKILL.md

Keyword Research

The unit of this work is the topic, and the win is being the page or the source that answers it. Keywords are evidence that a topic has demand, nothing more. This skill turns a business into a topic map: families of related searches and questions, each with its demand evidence, a verdict, and a ready brief for the ones worth doing now. Done means a short decision queue (NOW, NEXT, HOLD, DROP) another person could defend from the evidence, and briefs /seo-content can write from without researching again. The method is a floor. When the business in front of you argues for a better path, take it and say why in one line.

Context

Only if ./brand/, ./brands/ or MARKETING.md exists (nothing to load otherwise), run: python3 ${CLAUDE_SKILL_DIR}/../start-here/scripts/brand_context.py --for keyword-research (${CLAUDE_SKILL_DIR} is this skill's folder; outside Claude Code use the folder this file was read from, e.g. .agents/skills/keyword-research. If the script or python3 is unavailable, read the brand folder directly: ./brands/<slug>/ when ./brands/active names one, else ./brand/; then MARKETING.md, preferences.md and the files in reads:. If none exist, proceed standalone and ask only what you sell, who you serve, the site, and the goal: traffic, leads, sales or authority.)

Positioning shapes how you write about a topic, never which topics you target. A brand positioned as "the anti-agency" writes about "marketing strategy" with an anti-agency angle. It doesn't target "anti-agency" as a keyword.

Modes

  • Full research (no ./brand/keyword-plan.md): all phases.
  • Refresh (a plan exists): re-run Rung 2 on the existing NOW and NEXT families only, diff against the old plan, version the old copy, and summarize what moved. Don't rebuild unless asked.
  • Briefs only (the user names the keywords): Quick Mode. Skip to Rung 3 for those topics.
  • Local business: everything below applies, plus the Local branch. Questions about which services and towns get pages belong to /local-seo-plan; this skill maps the topics (guides, cost and symptom content, comparisons) around them.
Installs
205
GitHub Stars
767
First Seen
6 days ago