Agent skill

SEO Keyword Gap Audit

by rampstackco in rampstackco/claude-skills

Find keywords competitors rank for that the target property does not, and prioritize them by opportunity.

MITAuto-check passedMarketing & SEO

Install SEO Keyword Gap Audit

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rampstackco/claude-skills seo-keyword-gap-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-keyword-gap-audit .claude/skills/seo-keyword-gap-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-keyword-gap-audit
GitHub stars
940
Token cost
~2k tokens
SKILL.md length
957 words
Files
3 (incl. references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

Find keywords competitors rank for that the target property does not, and prioritize them by opportunity.

  • Works in 10 steps: Define the competitor set. 3-5… → Pull keyword data. For each property:… → Build the gap matrix. Label each keyword… → …
  • Planning content investment
  • SKILL.md covers When to use, When NOT to use, Required inputs and The framework: the gap matrix, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Keyword Gap Audit is an agent skill from rampstackco/claude-skills. 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…

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `README.md` and `references/opportunity-scoring-rubric.md`).

It sits in Marketing & SEO, covering Keyword research, Content strategy and Go-to-market strategy. It works with Model Context Protocol and Ahrefs. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.

When your agent uses it

  • Planning content investment
  • Identifying quick wins
  • Building a content calendar against a competitor set
  • Scoping a market entry

Example prompts

  • “/seo-keyword-gap-audit”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

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

What it can do on your machine

Read from SKILL.md and the folder at commit 482c9bf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Keyword Gap Audit loads about 2k tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 149 tokens; SKILL.md has 957 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~149
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 957 words, ~1,971 tokens.

Download SKILL.mdSave it as .claude/skills/seo-keyword-gap-audit/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from 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 ranksTarget does not rank
Competitors rankShared territory (defend and grow)Pure gap (the opportunity)
Competitors do not rankUnique 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
DimensionWhat it measuresWeight
Search volumeEstimated monthly searches in target market20%
Business relevanceHow close to a money topic for the target30%
DifficultyHow hard to rank (Ahrefs KD or proxy)15%
Intent matchWhether target can satisfy the dominant intent20%
Position potentialRealistic top 3 reach within 6 months15%

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
ScoreAction
80-100Top priority. Plan content this quarter.
60-79Strong priority. Plan within 6 months.
40-59Watch list. Revisit if competitive landscape shifts.
Below 40Park 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.
  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.

Show full SKILL.md (369 more words)Show less

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

© rampstackco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/seo-keyword-gap-audit of rampstackco/claude-skills.

  • SKILL.md
  • README.md
  • references/opportunity-scoring-rubric.md

Open the folder on GitHubat commit 482c9bf

Compare with similar skills

SEO Keyword Gap Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Keyword Gap Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Keyword Gap Audit this skillrampstackco/claude-skills940—~2kAutomated safety check: PassMIT
SEO APIseranking/seo-skills160—~4.1kAutomated safety check: PassMIT
Keyword Researchindranilbanerjee/digital-marketing-pro8551 repos~2kAutomated safety check: PassMIT
Mkt SEO Opsevolution-foundation/evo-nexus545—~1.1kAutomated safety check: NotesCustom licence
SEO Keyword ClusteringAgriciDaniel/claude-seo18k2 repos~3.3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo18k2 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • SEO API

    seranking/seo-skills

    SE Ranking API integration architect. An agent skill from seranking/seo-skills.

    160 GitHub stars~4.1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Keyword Research

    indranilbanerjee/digital-marketing-pro

    Standalone keyword research — expands seeds via the brand's connected keyword MCP (Ahrefs, Semrush, SE Ranking, or GSC), classifies search intent, maps keywords to content types, surfaces competitor…

    855 GitHub starsUsed in 1 repo~2k tokens
    Marketing & SEOAuto-check passed
  • Mkt SEO Ops

    evolution-foundation/evo-nexus

    AI-powered SEO operations with keyword intelligence, competitor gap analysis, GSC optimization, and trend detection.

    545 GitHub stars~1.1k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check: notes
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    18k GitHub starsUsed in 2 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    18k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • Keyword Research

    nowork-studio/notfair-plugin

    Finds, scores and groups keywords from a seed term or niche for SEO and AI search content strategies, with intent labels, difficulty estimates and topic clusters.

    3.9k GitHub starsUsed in 1 repo~2.6k tokens
    Marketing & SEOAuto-check passed

More from rampstackco/claude-skills

All 103 skills in this repo
  • After Action Report

    rampstackco/claude-skills

    Run 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.

    940 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    940 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Brand Style Guide

    rampstackco/claude-skills

    Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.

    940 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Brand Voice

    rampstackco/claude-skills

    Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.

    940 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Content And Copy

    rampstackco/claude-skills

    Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.

    940 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Content Strategy

    rampstackco/claude-skills

    Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.

    940 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

Questions about SEO Keyword Gap Audit

What does SEO Keyword Gap Audit do?

Find keywords competitors rank for that the target property does not, and prioritize them by opportunity. SEO Keyword Gap Audit is an agent skill from rampstackco/claude-skills. Find keywords competitors rank for that the target property does not, and prioritize them by opportunity.

When should I use SEO Keyword Gap Audit?

SEO Keyword Gap Audit fits situations like: planning content investment; identifying quick wins; building a content calendar against a competitor set; scoping a market entry.

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`. Or copy the skill folder (skills/seo-keyword-gap-audit in rampstackco/claude-skills) into .claude/skills/seo-keyword-gap-audit in your project. Claude Code loads it when a task matches its description.

How do I install SEO Keyword Gap Audit in Codex?

Run `npx skills add rampstackco/claude-skills --skill seo-keyword-gap-audit -a codex`. Or copy the skill folder (skills/seo-keyword-gap-audit in rampstackco/claude-skills) into .agents/skills/seo-keyword-gap-audit in your project. Codex loads it when a task matches its description.

Can I use SEO Keyword Gap Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rampstackco/claude-skills --skill seo-keyword-gap-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-keyword-gap-audit, .gemini/skills/seo-keyword-gap-audit, .github/skills/seo-keyword-gap-audit and .opencode/skills/seo-keyword-gap-audit in your project.

What does SEO Keyword Gap Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Keyword Gap Audit is instructions for the agent only.

Does SEO Keyword Gap Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Keyword Gap Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Keyword Gap Audit use?

SEO Keyword Gap Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Keyword Gap Audit use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to SEO Keyword Gap Audit?

Skills that share tags, products or a category with SEO Keyword Gap Audit: SEO API (seranking/seo-skills, 160 stars), Keyword Research (indranilbanerjee/digital-marketing-pro, 855 stars), Mkt SEO Ops (evolution-foundation/evo-nexus, 545 stars) and SEO Keyword Clustering (AgriciDaniel/claude-seo, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Keyword Gap Audit?

rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 940 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.

Source: rampstackco/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.