Keyword Research

This skill should be used when the user asks to "find keywords", "keyword research", "what should I write about", "keyword difficulty score", "search volume...

Security Scan

The skill is internally coherent for an SEO keyword-research assistant (Ahrefs is the primary integration) but has minor metadata/integration gaps you should be aware of before supplying credentials.

Purpose & Capability

The skill's name, description, and included reference materials are consistent with a keyword-research tool. The metadata designates AHREFS_API_KEY as the primary credential, which fits the stated Ahrefs integration. The SKILL.md also says it can work with SEMrush, Google Keyword Planner, and Google Search Console, but those additional connectors/credentials are not declared in requires.env. This is plausible (they may be optional or requested interactively) but is a minor mismatch between claimed multi-tool support and declared credentials.

Instruction Scope

The runtime instructions (SKILL.md) direct the agent to ask clarifying questions, accept manual data, and pull metrics when SEO tools / search console are 'connected.' There are no instructions that tell the agent to read arbitrary local files, secret stores, or system config. The skill does request network access implicitly to call external SEO APIs when available, which is expected for its purpose.

Install Mechanism

This is an instruction-only skill with no install spec and no code files to execute. That minimizes on-disk installation risk.

Credentials

Only AHREFS_API_KEY is declared as the primary credential, which is reasonable for Ahrefs-backed workflows. However, the skill advertises support for SEMrush, Google Keyword Planner, and Google Search Console without declaring corresponding required environment variables. If you plan to use those integrations, the skill will likely request additional credentials at runtime or expect manual uploads — the metadata does not make that explicit.

Persistence & Privilege

always:false (default) and there is no install behavior, so the skill does not request permanent presence or elevated platform privileges. The skill can be invoked autonomously by the agent (platform default), which is normal — note this only increases reach if you grant it credentials.

Assessment

This instruction-only SEO skill appears to do what it claims and uses Ahrefs as its primary integration. Before installing or enabling it: (1) only provide your AHREFS_API_KEY if you trust the author; (2) expect the skill to ask for or require additional credentials (SEMrush, Google Search Console, Google Keyword Planner) if you want those integrations — the registry metadata does not declare those env vars up front; (3) because the skill calls external SEO APIs, be cautious about granting it any account-scoped credentials (especially Search Console) — prefer read-only keys or manual data uploads when possible; (4) review the connectors or integration flow (where those credentials will be sent/stored) if that information is available; (5) since the skill is instruction-only and writes nothing to disk, it has a small local footprint, but network access combined with provided API keys can expose account data, so limit credentials to what is necessary. If you want higher confidence, ask the publisher for details on how non-Ahrefs connectors are handled and whether the skill ever logs or transmits full responses to third-party endpoints beyond the SEO tools themselves.

SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills

<details> <summary>Browse all 20 skills</summary>

Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis

Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator

Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher

Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager

Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management

</details>

Discovers, analyzes, and prioritizes keywords for SEO and GEO content strategies. Identifies high-value opportunities based on search volume, competition, intent, and business relevance.

When to Use This Skill

• Starting a new content strategy or campaign
• Expanding into new topics or markets
• Finding keywords for a specific product or service
• Identifying long-tail keyword opportunities
• Understanding search intent for your industry
• Planning content calendars
• Researching keywords for GEO optimization

What This Skill Does

1. Keyword Discovery: Generates comprehensive keyword lists from seed terms
2. Intent Classification: Categorizes keywords by user intent (informational, navigational, commercial, transactional)
3. Difficulty Assessment: Evaluates competition level and ranking difficulty
4. Opportunity Scoring: Prioritizes keywords by potential ROI
5. Clustering: Groups related keywords into topic clusters
6. GEO Relevance: Identifies keywords likely to trigger AI responses

How to Use

Basic Keyword Research

Research keywords for [topic/product/service]

Find keyword opportunities for a [industry] business targeting [audience]

With Specific Goals

Find low-competition keywords for [topic] with commercial intent

Identify question-based keywords for [topic] that AI systems might answer

Competitive Research

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

Data Sources

See CONNECTORS.md for tool category placeholders.

With ~~SEO tool + ~~search console connected: Automatically pull historical search volume data, keyword difficulty scores, SERP analysis, current rankings from ~~search console, and competitor keyword overlap. The skill will fetch seed keyword metrics, related keyword suggestions, and search trend data.

With manual data only: Ask the user to provide:

1. Seed keywords or topic description
2. Target audience and geographic location
3. Business goals (traffic, leads, sales)
4. Current domain authority (if known) or site age
5. Any known keyword performance data or search volume estimates

Proceed with the full analysis using provided data. Note in the output which metrics are from automated collection vs. user-provided data.

Instructions

When a user requests keyword research:

1. Understand the Context

   Ask clarifying questions if not provided:

   • What is your product/service/topic?
   • Who is your target audience?
   • What is your business goal? (traffic, leads, sales)
   • What is your current domain authority? (new site, established, etc.)
   • Any specific geographic targeting?
   • Preferred language?

2. Generate Seed Keywords

   Start with:

   • Core product/service terms
   • Problem-focused keywords (what issues do you solve?)
   • Solution-focused keywords (how do you help?)
   • Audience-specific terms
   • Industry terminology

3. Expand Keyword List

   For each seed keyword, generate variations:

   ## Keyword Expansion Patterns
   
   ### Modifiers
   - Best [keyword]
   - Top [keyword]
   - [keyword] for [audience]
   - [keyword] near me
   - [keyword] [year]
   - How to [keyword]
   - What is [keyword]
   - [keyword] vs [alternative]
   - [keyword] examples
   - [keyword] tools
   
   ### Long-tail Variations
   - [keyword] for beginners
   - [keyword] for small business
   - Free [keyword]
   - [keyword] software/tool/service
   - [keyword] template
   - [keyword] checklist
   - [keyword] guide
   

4. Classify Search Intent

   Categorize each keyword:

   Intent	Signals	Example	Content Type
   Informational	what, how, why, guide, learn	"what is SEO"	Blog posts, guides
   Navigational	brand names, specific sites	"google analytics login"	Homepage, product pages
   Commercial	best, review, vs, compare	"best SEO tools [current year]"	Comparison posts, reviews
   Transactional	buy, price, discount, order	"buy SEO software"	Product pages, pricing

5. Assess Keyword Difficulty

   Score each keyword (1-100 scale):

   ### Difficulty Factors
   
   **High Difficulty (70-100)**
   - Major brands ranking
   - High domain authority competitors
   - Established content (1000+ backlinks)
   - Paid ads dominating SERP
   
   **Medium Difficulty (40-69)**
   - Mix of authority and niche sites
   - Some opportunities for quality content
   - Moderate backlink requirements
   
   **Low Difficulty (1-39)**
   - Few authoritative competitors
   - Thin or outdated content ranking
   - Long-tail variations
   - New or emerging topics
   

6. Calculate Opportunity Score

   Formula: Opportunity = (Volume × Intent Value) / Difficulty

   Intent Value assigns a numeric weight by search intent:

   • Informational = 1
   • Navigational = 1
   • Commercial = 2
   • Transactional = 3

   ### Opportunity Matrix
   
   | Scenario | Volume | Difficulty | Intent | Priority |
   |----------|--------|------------|--------|----------|
   | Quick Win | Low-Med | Low | High | ⭐⭐⭐⭐⭐ |
   | Growth | High | Medium | High | ⭐⭐⭐⭐ |
   | Long-term | High | High | High | ⭐⭐⭐ |
   | Research | Low | Low | Low | ⭐⭐ |
   

7. Identify GEO Opportunities

   Keywords likely to trigger AI responses:

   ### GEO-Relevant Keywords
   
   **High GEO Potential**
   - Question formats: "What is...", "How does...", "Why is..."
   - Definition queries: "[term] meaning", "[term] definition"
   - Comparison queries: "[A] vs [B]", "difference between..."
   - List queries: "best [category]", "top [number] [items]"
   - How-to queries: "how to [action]", "steps to [goal]"
   
   **AI Answer Indicators**
   - Query is factual/definitional
   - Answer can be summarized concisely
   - Topic is well-documented online
   - Low commercial intent
   

8. Create Topic Clusters

   Group keywords into content clusters:

   ## Topic Cluster: [Main Topic]
   
   **Pillar Content**: [Primary keyword]
   - Search volume: [X]
   - Difficulty: [X]
   - Content type: Comprehensive guide
   
   **Cluster Content**:
   
   ### Sub-topic 1: [Secondary keyword]
   - Volume: [X]
   - Difficulty: [X]
   - Links to: Pillar
   - Content type: [Blog post/Tutorial/etc.]
   
   ### Sub-topic 2: [Secondary keyword]
   - Volume: [X]
   - Difficulty: [X]
   - Links to: Pillar + Sub-topic 1
   - Content type: [Blog post/Tutorial/etc.]
   
   [Continue for all cluster keywords...]
   

9. Generate Output Report

   Produce a report containing: Executive Summary, Top Keyword Opportunities (Quick Wins, Growth, GEO), Topic Clusters, Content Calendar, and Next Steps.

   Reference: See references/example-report.md for the full report template and example.

Validation Checkpoints

Input Validation

• Seed keywords or topic description clearly provided
• Target audience and business goals specified
• Geographic and language targeting confirmed
• Domain authority or site maturity level established

Output Validation

• Every recommendation cites specific data points (not generic advice)
• Search volume and difficulty scores included for each keyword
• Keywords grouped by intent and mapped to content types
• Topic clusters show clear pillar-to-cluster relationships
• Source of each data point clearly stated (~~SEO tool data, user-provided, or estimated)

Example

Reference: See references/example-report.md for a complete example report for "project management software for small businesses".

Advanced Usage

• Intent Mapping: Map all keywords for [topic] by search intent and funnel stage
• Seasonal Analysis: Identify seasonal keyword trends for [industry]
• Competitor Gap: What keywords do [competitor 1], [competitor 2] rank for that I'm missing?
• Local Keywords: Research local keywords for [business type] in [city/region]

Tips for Success

1. Start with seed keywords that describe your core offering
2. Don't ignore long-tail - they often have highest conversion rates
3. Match content to intent - informational queries need guides, not sales pages
4. Group into clusters for topical authority
5. Prioritize quick wins to build momentum and credibility
6. Include GEO keywords in your strategy for AI visibility
7. Review quarterly - keyword dynamics change over time

Reference Materials

• Keyword Intent Taxonomy — Complete intent classification with signal words and content strategies
• Topic Cluster Templates — Hub-and-spoke architecture templates for pillar and cluster content
• Keyword Prioritization Framework — Priority scoring matrix, categories, and seasonal keyword patterns
• Example Report — Complete example keyword research report for project management software

Related Skills

• competitor-analysis — See what keywords competitors rank for
• content-gap-analysis — Find missing keyword opportunities
• seo-content-writer — Create content for target keywords
• geo-content-optimizer — Optimize for AI citations
• rank-tracker — Monitor keyword position changes over time