Skip to main content
skill CX Codex

seo-keyword-gap-audit — Claude Code skill

The seo-keyword-gap-audit skill compares your site's organic footprint against competitors and flags keywords they rank for that you don't. Use it to plan content investment, spot quick wins, or scope market entry.

MIT 287 installs ★ 1,107 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rampstackco/claude-skills --skill seo-keyword-gap-audit -a claude-code
Open on GitHub

What seo-keyword-gap-audit does

The skill builds a gap matrix: keywords competitors rank for in the top 10 where you rank on page 3 or lower (the core opportunity). It scores each keyword on five dimensions: search volume (20% weight), business relevance (30%), ranking difficulty (15%), intent match (20%), and realistic top-3 potential (15%). Scores run 0–100, banded as top priority (80+), strong (60–79), watch list (40–59), or park (<40).

Requires Ahrefs MCP for keyword and traffic data. Inputs: target property, 3–5 competitors with overlapping search intent and audience, market, language, business priorities, and existing content inventory. Output includes an executive summary, gap matrix, scored opportunity list, topic clusters, action map (create / update / merge), and quick wins.

Common pitfalls: picking competitors by brand familiarity instead of SERP overlap, chasing high volume over realistic difficulty, ignoring SERP intent, and skipping topic clustering. The skill guides the logic but depends on a sound competitor set and business-relevance filter.

What it helps with

  • identify keywords competitors rank for that you miss
  • prioritize content investment against a competitor set
  • find high-opportunity, low-difficulty quick wins
  • group related keywords into actionable content topics
  • assess growth ceiling and competitive gaps for market entry

Example prompts for the agent

  • Find keyword gaps between our B2B SaaS site and top three competitors in the vertical
  • Build a gap matrix for our e-commerce store against Wildberries and Ozon
  • What keywords do we miss with >100 monthly searches and ranking difficulty <40?

How to install seo-keyword-gap-audit

1Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill seo-keyword-gap-audit -a claude-code

2Manually: put the files in place

~/.claude/skills/seo-keyword-gap-audit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-keyword-gap-audit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seo-keyword-gap-audit

How do I install seo-keyword-gap-audit in Claude Code?

Run npx skills add rampstackco/claude-skills --skill seo-keyword-gap-audit -a claude-code, then review the config at ~/.claude/skills/seo-keyword-gap-audit/SKILL.md.

What does seo-keyword-gap-audit do?

It finds keywords your competitors rank for but you don't, scores each by search volume, business fit, and ranking difficulty, clusters them by topic, and maps actions (create, update, or merge pages).

What inputs does the skill need?

Target property, competitor set (3–5), target market and language, business priorities, existing content inventory, and a connected Ahrefs MCP server for keyword and traffic data.

Source text

SKILL.md · MIT
---
name: seo-keyword-gap-audit
description: "Find keywords competitors rank for that the target property does not, and prioritize them by opportunity. Uses Ahrefs MCP for keyword and competitor data. Use this skill when planning content investment, identifying quick wins, building a content calendar against a competitor set, or scoping a market entry. Triggers on keyword gap, content gap, competitor keywords, opportunity keywords, what should we target, where are competitors winning, keyword opportunity. Also triggers when planning content for a new market or after losing organic share to a specific competitor."
category: seo-audit-suite
catalog_summary: "Competitor keyword gaps with opportunity scoring and clustering"
display_order: 3
---

# SEO Keyword Gap Audit

Find keyword opportunities by comparing the target property's organic footprint against a competitor set, using Ahrefs MCP data. Stack-agnostic. Produces a prioritized list of keywords to target with new or improved content.

---

## When to use

- Planning content investment for the next quarter
- Identifying quick-win keywords for fast organic gains
- Scoping market entry into a new vertical
- Refreshing a stale content strategy
- Diagnosing why a competitor is gaining organic share
- Pre-acquisition due diligence on growth ceiling

## When NOT to use

- Pure keyword discovery without a competitor frame (use `seo-keyword`)
- Single-page optimization (use `seo-onpage`)
- Content audit on existing pages (use `seo-content-audit`)
- Topic and pillar planning (use `content-strategy`)

---

## Required inputs

- Target property
- Competitor set (3-5 properties with overlapping intent and audience)
- Target market and language
- Business priorities (which segments matter most)
- Existing content inventory (URLs and primary topics)
- Confirmation Ahrefs MCP is connected

---

## The framework: the gap matrix

A keyword can fall into one of four cells based on whether the target ranks and whether competitors rank.

|  | Target ranks | Target does not rank |
| --- | --- | --- |
| **Competitors rank** | Shared territory (defend and grow) | Pure gap (the opportunity) |
| **Competitors do not rank** | Unique territory (asset to protect) | Untouched (validate before investing) |

The audit focuses primarily on the "pure gap" cell. The other cells get secondary treatment.

### Pure gap (top focus)

Keywords where one or more competitors rank in the top 10 and the target does not rank at all or ranks past page 3. These are the primary opportunities.

### Shared territory

Keywords where both target and competitors rank. Useful for defending position and finding pages to push from page 2 to page 1.

### Unique territory

Keywords where the target ranks and no competitor does. These are differentiators. Audit to confirm they are actually valuable (not just irrelevant terms).

### Untouched

Keywords no one in the set ranks for. Could be opportunity or could be irrelevant. Validate intent before investing.

---

## Opportunity scoring

Not every gap keyword is worth pursuing. Score each candidate.

### Scoring dimensions

| Dimension | What it measures | Weight |
| --- | --- | --- |
| Search volume | Estimated monthly searches in target market | 20% |
| Business relevance | How close to a money topic for the target | 30% |
| Difficulty | How hard to rank (Ahrefs KD or proxy) | 15% |
| Intent match | Whether target can satisfy the dominant intent | 20% |
| Position potential | Realistic top 3 reach within 6 months | 15% |

Weights adjust based on goal. For quick wins, weight position potential and difficulty higher. For strategic territory, weight business relevance and volume higher.

### Opportunity score formula

```
score = (volume_normalized * 0.2)
      + (relevance_score * 0.3)
      + (difficulty_inverted * 0.15)
      + (intent_match * 0.2)
      + (position_potential * 0.15)
```

Where each input is normalized to 0-100. The result is a 0-100 score.

### Banding for action

| Score | Action |
| --- | --- |
| 80-100 | Top priority. Plan content this quarter. |
| 60-79 | Strong priority. Plan within 6 months. |
| 40-59 | Watch list. Revisit if competitive landscape shifts. |
| Below 40 | Park or drop. |

---

## Workflow

1. **Define the competitor set.** 3-5 properties. Confirm they share intent and audience.
2. **Pull keyword data.** For each property: organic keywords, top pages, traffic estimates.
3. **Build the gap matrix.** Label each keyword with which property ranks where.
4. **Filter to the pure gap cell.** Strip out the other cells for now.
5. **Validate intent.** For each keyword, confirm the SERP intent matches what the target can produce.
6. **Score by opportunity.** Use the formula. See [`references/opportunity-scoring-rubric.md`](references/opportunity-scoring-rubric.md).
7. **Cluster.** Group related keywords into topics. One topic, one piece of content.
8. **Map to existing content.** Some gap keywords are addressable by updating an existing page rather than creating new.
9. **Sequence.** Build the prioritized list with action (create / update / merge / new pillar).
10. **Hand off.** Output feeds `content-strategy` and `seo-onpage`.

---

## Failure patterns

- **Wrong competitor set.** Choosing competitors by brand recognition rather than SERP overlap produces gap lists that are not actually competitive. Pick competitors that fight you in the SERPs.
- **Volume worship.** High-volume gap keywords are often unrealistic. A 50-volume keyword you can rank for beats a 5,000-volume keyword you cannot.
- **Ignoring intent.** A gap keyword where the SERP is dominated by tools or marketplaces is not addressable by an article. Match content type to intent.
- **Skipping clustering.** Targeting individual keywords instead of topics produces thin content that loses to topical hubs.
- **Over-relying on Ahrefs KD.** Difficulty scores are heuristics. Look at the actual SERP. If it is dominated by Forbes and Wikipedia, KD is misleadingly low.
- **No business filter.** A high-volume gap with zero buyer intent is a vanity opportunity. Filter for relevance.
- **One-shot audits.** Gap closes and reopens as competitors publish. Rerun on a cadence.
- **Forgetting unique territory.** Defending what you uniquely rank for can be more valuable than chasing gaps. Audit both directions.
- **Single-language audits in multi-market sites.** Run separate gap audits per market. Patterns differ.

---

## Output format

A keyword gap audit document with:

1. **Executive summary.** Top 3 themes and top 10 priority keywords.
2. **Competitor set.** Who, why selected, SERP overlap evidence.
3. **The gap matrix.** Counts and patterns across the four cells.
4. **Pure gap analysis.** The opportunity list, scored and banded.
5. **Topic clusters.** Groups of related keywords mapped to content concepts.
6. **Action map.** Create / update / merge decisions per cluster.
7. **Quick wins.** Top 5-10 highest-confidence opportunities.
8. **Strategic plays.** High-impact, longer-horizon investments.
9. **Methodology.** Data sources, scoring weights, caveats.

Length: 6-15 pages plus an attached opportunity spreadsheet.

---

## If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.

---

## Reference files

- [`references/opportunity-scoring-rubric.md`](references/opportunity-scoring-rubric.md) - Scoring rubric with normalization rules, formula, and worked examples.

© rampstackco · MIT · rampstackco/claude-skills

Similar skills

All skills for SEO and GEO →

From the same set102

The whole set →
lead-magnet-design lead-magnet-design — a growth methodology skill to structure gated offers, checklists, and templates that qualify audience interest before collecting emails. CX Codex +1 289installs programmatic-seo Architect durable programmatic SEO systems from structured data without triggering search engine thin-content penalties. CX Codex +1 289installs seo-backlink-audit seo-backlink-audit reviews backlink quality via Ahrefs MCP: whether your profile is healthy, which links are risky, what you've lost, and how you stack against rivals. CX Codex +1 288installs seo-audit-orchestration seo-audit-orchestration runs a full SEO audit through Ahrefs MCP, coordinates focused checks, and turns their findings into one prioritized report. CX Codex +1 287installs ai-content-collaboration ai-content-collaboration — a workflow guide for teams using AI in content production, with clear boundaries between model-assisted tasks and editorial decisions. CX Codex +1 287installs pm-spec-writing pm-spec-writing converts vague ideas and requests into clear briefs, PRDs, and bug reports that developers can build from. Clarifies what needs building before code starts. CX Codex +1 286installs calculator-design The calculator-design skill helps plan ROI, pricing, savings, mortgage, and custom calculators. It focuses on useful decision support instead of hiding a weak result behind a lead form. CX Codex +1 286installs content-distribution content-distribution is a Claude Code skill for matching content and audiences to distribution channels. It addresses stalled reach and teams posting everywhere without a strategy. CX Codex +1 285installs

Project sponsors

Companies that keep this analytics open