NanoSkill
Добавить навык

Keyword Research Skill

отaaron-he-zhu27звезды GitHubGitHub

Perform keyword research that scores volume, difficulty, and intent for SEO and GEO. Get a prioritized brief with clusters and content ideas.

keywordПроверка безопасности пройдена
Превью результата

Полное демо

See a prioritized keyword strategy with high opportunity terms, keyword insights, and actionable content opportunities generated by this Agent Skill.

Начало работы

Запустите первую задачу

  1. a simple demonstration of the first step in using Keyword Research Skill
    01

    Install

    Add the Keyword Research Skill to your AI agent.

  2. a simple demonstration of the second step in using Keyword Research Skill
    02

    Describe Task

    Describe your website, topic, or SEO goals to discover and evaluate relevant keywords.

  3. a simple demonstration of the third step in using Keyword Research Skill
    03

    Build Strategy

    Get prioritized keywords, keyword insights, and actionable content opportunities ready for execution.

Команда установки

$ npx skills add https://github.com/aaron-he-zhu/seo-geo-claude-skills/tree/main/research/keyword-research

Сигналы установки

Активность установки

Описание

The Keyword Research skill helps SEOs and content strategists find high-opportunity keywords for new pages, topics, or campaigns. It combines volume, difficulty, and intent scoring with a GEO-readiness check, delivering a prioritized brief of Quick Wins, Growth, and GEO-rich terms you can act on immediately.

Unlike simple list expansions, the skill runs an 8-phase workflow — from scoping through discovery, classification, scoring, and clustering. It can mine your existing Search Console data for “striking-distance” terms (positions 5–20), and even harvest free keyword ideas from Google Autocomplete with a local script, so you're never blocked waiting for tool data.

Whether you're building a new site architecture, planning a content calendar, or optimizing for AI-assisted search, the skill provides actionable deliverables: topic cluster maps, a content calendar, and ready-to-use keyword tables. All metrics are clearly labeled as measured, user-provided, or estimated — no guesswork disguised as data.

Ключевые функции

Почему это мощно

  • 8-Phase Research Workflow

    Complete keyword research in structured steps, from scoping to final deliverables like executive summaries and content calendars.

  • Intelligent Scoring & Prioritization

    Score keywords by difficulty and a custom opportunity metric that balances volume and intent; get instant Quick Wins, Growth, and GEO opportunity lists.

  • GEO-Optimized Recommendations

    Automatically flag question-based, comparison, and how-to queries that perform well in AI-generated answers and featured snippets.

  • Topic Cluster Mapping

    Group discovered keywords into pillar and cluster hubs so you can build authoritative content architectures faster.

  • Zero-Dependency Autocomplete

    Harvest keyword ideas from Google Autocomplete with a built-in helper — no API keys or paid tools required.

Сценарии

Когда использовать

  • Generate a keyword brief for a new page or topic

    Enter a seed keyword and get a full research brief with volume, difficulty, intent labels, and cluster groups to guide your content strategy.

  • Identify quick-win keywords for immediate impact

    Surface low-difficulty, high-opportunity terms your site can rank for quickly, using your own Search Console data or provided estimates.

  • Build topic clusters to boost site authority

    Map pillar pages and supporting cluster content directly from research, aligning your site structure with search intent.

  • Optimize content for AI-powered search

    Pinpoint GEO-friendly queries like definitions, step-by-step guides, and comparison questions that are favored by AI overviews and voice search.

SKILL.md

Keyword Research

Discovers, scores, and clusters keywords for SEO and GEO planning.

Quick Start

Research keywords for [topic/product/service]

What keywords is [competitor URL] ranking for that I should target?

Skill Contract

Expected output: a prioritized keyword brief plus the standard handoff summary for memory/research/.

  • Reads: topic or seed keyword, target market/language, business goal, site DR, and any user-provided or tool metrics.
  • Writes: a user-facing research deliverable and reusable summary.
  • Promotes: durable keyword priorities, competitor facts, and pending strategy decisions to memory/hot-cache.md, memory/open-loops.md, and memory/research/.
  • Done when: every shortlisted keyword carries volume + difficulty + intent (or a labeled N/A); keywords are grouped into pillar + cluster hubs; and the deliverable names at least 3 prioritized Quick Win / Growth / GEO opportunities.
  • Primary next skill: competitor-analysis when the keyword set is ready for market comparison.

Handoff Summary

Emit the standard shape from skill-contract.md §Handoff Summary Format.

Data Sources

Optional integrations: ~~SEO tool, ~~search console. Without tools, ask for seed keywords, audience, goals, and any known metrics. See CONNECTORS.md.

Zero-dependency local helper (no tool needed): python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/suggest.py" "<seed>" --expand harvests free keyword ideas from Google Autocomplete (⚠️ unofficial endpoint). Search volume / difficulty still needs ~~SEO tool or own Search Console data. See scripts/connectors/README.md.

Striking-distance shortcut (when ~~search console is connected): before broad discovery, mine your own GSC query data for terms already ranking in positions ~5–20 — page-one tail and page two. These are proven demand a small push can convert, so they are the fastest opportunity set. The Search Analytics API sorts by clicks and has no position filter, so request a high rowLimit and filter the 5–20 window client-side, then attach volume / difficulty / intent to that shortlist. Work this set first; treat its metrics as Measured.

Instructions

When a user requests keyword research, run eight phases and announce each as [Phase X/8: Name]:

  1. Scope — clarify product, audience, business goal, DR, geography, and language.
  2. Discover — seed from core, problem, solution, audience, and industry terms.
  3. Variations — expand with modifiers and long-tail patterns.
  4. Classify — tag by intent (informational, navigational, commercial, transactional).
  5. Score — assign difficulty (1-100) and compute Opportunity = (Volume × Intent Value) / Difficulty, with Intent Value 1 / 1 / 2 / 3.
  6. GEO-Check — flag AI-answer-friendly queries such as questions, definitions, comparisons, lists, and how-tos.
  7. Cluster — group keywords into pillar + cluster topic hubs.
  8. Deliver — output an Executive Summary, Quick Wins / Growth / GEO opportunities, Topic Clusters, Content Calendar, and Next Steps.

Label every metric Measured (tool/export), User-provided, or Estimated (model inference); never present an estimate as measured; if a required metric is unavailable, mark it N/A — do not invent it.

Quality bar: every recommendation includes at least one specific number. Rewrite generic advice into a concrete keyword + volume + difficulty + reason.

Reference: See references/instructions-detail.md for the full 8-phase templates, expansion patterns, intent table, difficulty tiers, opportunity matrix, GEO indicators, cluster template, actionable-vs-generic examples, and advanced usage.

Example

See references/example-report.md for a full worked sample.

Save Results

Write path: memory/research/keyword-research/YYYY-MM-DD-<topic>.md; promote durable keyword priorities to memory/hot-cache.md. See Skill Contract §Save Results Template.

Reference Materials

  • Instructions Detail — Workflow, scoring, cluster template, advanced usage
  • Keyword Intent Taxonomy — Intent signals and content mapping
  • Topic Cluster Templates — Pillar and cluster patterns
  • Keyword Prioritization Framework — Scoring and prioritization rules
  • Example Report — Worked sample

Next Best Skill

Primary: competitor-analysis. Also: content-gap-analysis and serp-analysis.

FAQ