Source profileQuality 84/100

nowork-studio/NotFair/seo/keyword-research/SKILL.md

keyword-research

Discover, analyze, and prioritize keywords for SEO and GEO content strategies from a seed keyword or niche. Identifies high-value opportunities based on search volume, competition, intent, and business relevance. Generates topic clusters. For building a dated editorial calendar from your own Search Console data, use `content-planner` instead — this skill is seed-driven keyword discovery, not calendar scheduling. Use when asked to "find keywords", "keyword research", "keyword analysis", "search v

Source repository stars
3,314
Declared platforms
0
Static risk flags
0
Last source update
2026-07-31
Source checked
2026-08-04

Decision brief

What it does—and where it fits

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

Best for

  • Use when asked to "find keywords", "keyword research", "keyword analysis", "search v

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/nowork-studio/NotFair --skill "seo/keyword-research"
Safe inspection promptEditorial

Inspect the Agent Skill "keyword-research" from https://github.com/nowork-studio/NotFair/blob/e682cc9f630d242d78a696763ab5f5fd852eff28/seo/keyword-research/SKILL.md at commit e682cc9f630d242d78a696763ab5f5fd852eff28. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Quick Start

    Start with one of these prompts.

    Start with one of these prompts.
  2. 02

    Instructions

    When a user requests keyword research:

    Understand the ContextWhat is your product/service/topic?Who is your target audience?
  3. 03

    Advanced Usage

    Intent Mapping: Map all keywords for [topic] by search intent and funnel stage

    Intent Mapping: Map all keywords for [topic] by search intent and funnel stageSeasonal Analysis: Identify seasonal keyword trends for [industry]Competitor Gap: What keywords do [competitor 1], [competitor 2] rank for that I'm missing?
  4. 04

    When This Must Trigger

    Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:

    Starting a new content strategy or campaignExpanding into new topics or marketsFinding keywords for a specific product or service
  5. 05

    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. Oppo…

    Keyword Discovery: Generates comprehensive keyword lists from seed termsIntent Classification: Categorizes keywords by user intent (informational, navigational, commercial, transactional)Difficulty Assessment: Evaluates competition level and ranking difficulty

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score84/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars3,314SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
nowork-studio/NotFair
Skill path
seo/keyword-research/SKILL.md
Commit
e682cc9f630d242d78a696763ab5f5fd852eff28
License
MIT
Collected
2026-08-04
Default branch
main
View the original SKILL.md

Keyword Research

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 This Must Trigger

Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:

Use this whenever the task needs reusable market intelligence that should influence strategy, not just an ad hoc answer.

  • 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

Quick Start

Start with one of these prompts.

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

Note: All integrations are optional. This skill works without any API keys — users provide data manually when no tools are connected.

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:

    IntentSignalsExampleContent Type
    Informationalwhat, how, why, guide, learn"what is SEO"Blog posts, guides
    Navigationalbrand names, specific sites"google analytics login"Homepage, product pages
    Commercialbest, review, vs, compare"best SEO tools [current year]"Comparison posts, reviews
    Transactionalbuy, 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

Next Best Skill

  • Primary: content-writer — turn keyword opportunities into optimized content.

Alternatives

Compare before choosing

Computed 9028

MoizIbnYousaf/marketing-cli

keyword-research

Strategic keyword research powered by web search and brand context. Use this skill whenever the user mentions keywords, keyword research, SEO topics, content topics, 'what should I write about', content strategy, blog ideas, search traffic, or content planning. Also trigger when the user wants to plan what content to create, when existing content isn't attracting search traffic, when any skill needs keyword-plan.md but it doesn't exist, or when the user asks about SEO in the context of content c

Computed 852,504

aaron-he-zhu/aaron-marketing-skills

keyword-research

Use it for engineering and marketing tasks; the detail page covers purpose, installation, and practical steps.

Computed 953,314

nowork-studio/NotFair

content-writer

Write SEO-optimized blog posts, landing pages, and content improvements following Google's E-E-A-T and Helpful Content guidelines. Handles new content creation from a keyword or topic, and improving existing pages. Use when asked to "write a blog post", "create a landing page", "improve this page", "write content about X", "content for keyword X", "draft an article", "blog post about", "landing page for", "service page", "product page copy", "rewrite this page", "make this page rank better", "co

Computed 94413

notque/vexjoy-agent

marketing

Marketing: SEO audits, campaign planning, content strategy, email sequences, competitive analysis, brand review, performance reporting.