seo-keyword-gap-audit

$npx mdskill add rampstackco/claude-skills/seo-keyword-gap-audit

Find and prioritize competitor keyword gaps using Ahrefs data.

  • Identifies keywords competitors rank for that the target does not.
  • Depends on Ahrefs MCP for keyword and competitor data.
  • Prioritizes keywords by opportunity using scoring and clustering.
  • Delivers a prioritized list of keywords for content targeting.

SKILL.md

.github/skills/seo-keyword-gap-auditView on GitHub ↗
---
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.

---

## Reference files

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

More from rampstackco/claude-skills

SkillDescription
ads-creative-developmentHow to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.
ads-performance-analyticsHow to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.
after-action-reportRun a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.
ai-content-collaborationHow humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.
analytics-strategyDesign measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.
art-directionDirect visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, write a creative direction document, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables.
backup-and-disaster-recoveryPlan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.
beta-program-managementRunning closed and open betas that produce real signal. Beta participant selection, structured feedback collection, beta-to-GA decision criteria, and the difference between soft-launch (no structure, no signal), kitchen-sink (everyone in, no actionable feedback), and structured beta (calibrated cohort, intentional feedback loops, clear graduation criteria). Triggers on beta program, alpha test, beta cohort, beta participant, beta feedback, beta to GA decision, design partner, early access program, closed beta, open beta, RC release. Also triggers when a feature is approaching launch and the team needs structured pre-GA validation, when prior betas produced noise rather than signal, or when the team has soft-launched before but wants more structured feedback this time.
brand-archetype-systemApply pre-composed aesthetic archetype defaults to jumpstart brand design work covering color, typography, layout, voice, and imagery direction. Use this skill whenever the user wants a starting point for brand visual and verbal direction, references a brand they want to design near (for example 'something like Stripe' or 'editorial like Linear'), needs to converge faster from many directions to one, or wants known-good defaults for a specific industry vertical. Triggers on archetype, design archetype, brand archetype, near to (brand), in the style of, similar aesthetic, design starting point, brand template, vertical-typical, industry-typical. Also triggers when the user has a brief and wants to map it to a known aesthetic family rather than design from first principles.
brand-discoveryRun upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration. Use this skill at the very start of a brand or website project when the user needs to understand who they're for, who they compete with, what the audience actually needs, and where the brand could plausibly stand. Triggers on brand discovery, audience research, market research, competitive scan, category research, customer research, who is this for, who are we, positioning research, intake, kickoff. Also triggers when a creative brief is requested but the upstream inputs (audience, competitors, problem space) are not yet clear.