Agent skill

SEO Content Gap Audit

by rampstackco in rampstackco/claude-skills

Audit content gaps and decay using Ahrefs MCP data: missing topics, thin coverage, outdated content, and decaying pages.

MITAuto-check passedMarketing & SEO

Install SEO Content Gap Audit

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

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

GitHub CLI
$ gh skill install rampstackco/claude-skills seo-content-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-content-gap-audit .claude/skills/seo-content-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-content-gap-audit
GitHub stars
940
Token cost
~2.3k tokens
SKILL.md length
1,142 words
Files
3 (incl. references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

Audit content gaps and decay using Ahrefs MCP data: missing topics, thin coverage, outdated content, and decaying pages.

  • Works in 10 steps: Charter the audit. Scope (whole site or… → Pull the inventory. Every URL, with… → Pull competitor coverage. Top pages and… → …
  • Planning a content roadmap
  • SKILL.md covers When to use, When NOT to use, Required inputs and The framework: 4 categories of…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Content Gap Audit is an agent skill from rampstackco/claude-skills. Audit content gaps and decay using Ahrefs MCP data: missing topics, thin coverage, outdated content, and decaying pages. Use this skill when planning a content roadmap, refreshing a stale catalog, building topical authority, or identifying which existing pages need update versus replacement. Triggers on content gap, content audit, content refresh, content roadmap, decaying content, content decay, topical authority, what topics should we cover, where is competitor content stronger. Also triggers when organic…

Its SKILL.md is about 2.3k 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/content-decision-matrix.md`).

It sits in Marketing & SEO, covering On-page SEO, Content strategy and Content marketing. It works with Ahrefs and Model Context Protocol. 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 a content roadmap
  • Refreshing a stale catalog
  • Building topical authority
  • Identifying which existing pages need update versus replacement

Example prompts

  • “/seo-content-gap-audit”

Workflow steps

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

  1. Charter the audit. Scope (whole site or section), goal, time window for performance data.
  2. Pull the inventory. Every URL, with publish date, primary topic, organic clicks, ranked keywords.
  3. Pull competitor coverage. Top pages and content clusters from each competitor.
  4. Classify each existing page. Healthy / thin / outdated / decaying / off-topic.
  5. Identify missing topics. Cross-reference competitor top pages and keyword gap output.
  6. Score each opportunity. See references/content-decision-matrix.md.
  7. Cluster. Group related missing topics into pillar concepts.
  8. Decide actions. Create / update / merge / redirect / prune for each opportunity.
  9. Sequence the roadmap. Quarter by quarter, with effort estimates and traffic forecasts.
  10. Hand off. Output feeds content-strategy, content-and-copy, 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 Content Gap Audit loads about 2.3k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 145 tokens; SKILL.md has 1,142 words of instructions outside code blocks.

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

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). 1,142 words, ~2,280 tokens.

Download SKILL.mdSave it as .claude/skills/seo-content-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-content-gap-audit
description
Audit content gaps and decay using Ahrefs MCP data: missing topics, thin coverage, outdated content, and decaying pages. Use this skill when planning a content roadmap, refreshing a stale catalog, building topical authority, or identifying which existing pages need update versus replacement. Triggers on content gap, content audit, content refresh, content roadmap, decaying content, content decay, topical authority, what topics should we cover, where is competitor content stronger. Also triggers when organic traffic is flat despite consistent publishing.
category
seo-audit-suite
catalog_summary
Missing topics, thin coverage, outdated content, decay diagnosis
display_order
4

SEO Content Gap Audit

Find content gaps and decay using Ahrefs MCP data. Stack-agnostic. Produces a roadmap of create, update, merge, and prune actions across the existing content catalog and identified topic gaps.


When to use

  • Planning the next quarter or half of content investment
  • Refreshing a stale or underperforming content catalog
  • Building topical authority in a target space
  • Identifying decaying pages before they tank traffic
  • Audit prep before a major site redesign or migration
  • Diagnosing why content investment is not driving organic growth

When NOT to use

  • Pure keyword research (use seo-keyword)
  • Competitor keyword gap (use seo-keyword-gap-audit)
  • Single-page optimization (use seo-onpage)
  • Pure prune-and-redirect decisions (use seo-content-audit)
  • New site planning with no existing content (use content-strategy)

Required inputs

  • Target property and content scope
  • Competitor set (3-5 properties with comparable content depth)
  • Target topics or pillars (if defined)
  • Existing content inventory with URLs, primary topics, publish dates
  • Performance data (organic clicks per page, ranked keywords per page)
  • Confirmation Ahrefs MCP is connected

The framework: 4 categories of content opportunity

Every content opportunity falls into one of four categories. Different categories need different actions.

Content gap analysis is sharper with multiple data sources. Ahrefs surfaces keyword and topic gaps (the primary backend below). Similarweb surfaces traffic-driving page-level gaps (which of a competitor's pages earn meaningful traffic, not just rankings). Semrush surfaces SERP-feature gaps (where competitors win answer boxes, knowledge panels, People Also Ask placements). The three platforms often disagree on individual data points; that disagreement is itself a useful signal.

Category 1: Missing topics

Topics with traffic potential where the property has no relevant page at all. Competitors often rank in the top 10. The fix: create new content.

Pulled from:

  • Ahrefs Content Explorer (top performing content in target topics)
  • Competitor top pages (Ahrefs Site Explorer)
  • Keyword gap audit output (clustered into topics)
Category 2: Thin coverage

Topics where the property has a page but it is too shallow, narrow, or single-keyword to compete with topical hubs. Competitor pages cover the topic across multiple subtopics. The fix: deepen the existing page or expand into a topic cluster.

Pulled from:

  • Pages ranking on page 2-3 for target keywords
  • Pages with low organic click share relative to ranked keyword volume
  • Pages where competitors have longer or broader equivalents
Category 3: Outdated content

Pages that ranked well historically but have lost ground due to staleness. Information is dated, examples are old, the SERP intent has shifted. The fix: refresh with current information and re-promote.

Pulled from:

  • Pages with declining organic clicks over the last 6-12 months
  • Pages with publish dates over 18 months old
  • Pages with ranked keywords slipping in position
Category 4: Decaying content

Pages that have lost traffic for reasons not obviously about staleness: SERP feature changes, competitor publishing, intent shifts, internal linking dilution. The fix: diagnose why, then refresh, merge, or redirect.

Pulled from:

  • Pages with sharp recent traffic drops
  • Pages where SERP composition has shifted (more video, more featured snippets, AI overviews)
  • Pages that compete with newer pages on the same site (cannibalization)

Workflow

  1. Charter the audit. Scope (whole site or section), goal, time window for performance data.
  2. Pull the inventory. Every URL, with publish date, primary topic, organic clicks, ranked keywords.
  3. Pull competitor coverage. Top pages and content clusters from each competitor.
  4. Classify each existing page. Healthy / thin / outdated / decaying / off-topic.
  5. Identify missing topics. Cross-reference competitor top pages and keyword gap output.
  6. Score each opportunity. See references/content-decision-matrix.md.
  7. Cluster. Group related missing topics into pillar concepts.
  8. Decide actions. Create / update / merge / redirect / prune for each opportunity.
  9. Sequence the roadmap. Quarter by quarter, with effort estimates and traffic forecasts.
  10. Hand off. Output feeds content-strategy, content-and-copy, and seo-onpage.

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

The action decision matrix

For each piece of existing content or proposed new content, decide one action.

SignalAction
Strong page, healthy traffic, current informationKeep. Defend with internal linking and refresh on schedule.
Page exists, ranking on page 2-3, content is thin vs SERPUpdate. Deepen, restructure, broaden.
Page exists, traffic declining, content is datedRefresh. Update facts, examples, year references, screenshots.
Page exists, low or zero traffic, low ranking, no improvement pathPrune or merge. Redirect to a stronger relative if one exists.
Multiple pages on overlapping topicsMerge into one canonical page. Redirect the others.
Topic missing entirely, competitor coverage strongCreate new page or pillar.
Topic missing, but competitors do not rank well eitherValidate intent before investing. Could be an opportunity or could be a dead end.
Page is off-topic for the propertyRedirect to most relevant page or remove from sitemap.

Failure patterns

  • All-create, no-update bias. Teams default to creating new content. Updates and merges often outperform new pieces by a wide margin and at lower cost.
  • Treating publish date as currency. A 5-year-old page can outrank a 1-month-old page if it is better. Stop deleting old content reflexively.
  • Cannibalization blind spots. Two pages on overlapping topics dilute each other. Audit for it explicitly.
  • No effort estimates. A roadmap without effort sizes cannot be sequenced realistically.
  • No traffic forecast. A roadmap without forecasted impact loses funding fights. Forecast even with wide confidence bands.
  • Refreshing without re-promotion. A refreshed page needs a re-crawl signal: update sitemap, internal links, distribution.
  • Ignoring intent shift. Some keywords have shifted from informational to transactional or to AI-answer-dominated. Recognize when the SERP is no longer addressable by the existing format.
  • Confusing decay with seasonality. A 30% click drop in summer for a back-to-school topic is not decay. Compare year-over-year, not month-over-month.
  • Auditing in isolation from the keyword gap. The two audits feed each other. Run them adjacent.

Output format

A content gap audit document with:

  1. Executive summary. Top 3 themes, content health verdict, recommended quarterly investment split.
  2. Content inventory snapshot. Counts by health classification.
  3. Missing topics. Prioritized list with cluster mapping and traffic forecast, or state the gap per the data-availability rule.
  4. Thin coverage. Pages to deepen, with recommendation for each.
  5. Outdated content. Pages to refresh, with refresh scope.
  6. Decaying content. Pages to diagnose and act on, with hypothesis for each.
  7. Cannibalization findings. Page pairs to merge.
  8. Action roadmap. Quarter by quarter, with effort and forecast.
  9. Methodology. Data sources, classification criteria, caveats.

Length: 8-15 pages plus an attached inventory 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-content-gap-audit of rampstackco/claude-skills.

  • SKILL.md
  • README.md
  • references/content-decision-matrix.md

Open the folder on GitHubat commit 482c9bf

Compare with similar skills

SEO Content 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 Content Gap Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Content Gap Audit this skillrampstackco/claude-skills940—~2.3kAutomated safety check: PassMIT
SEO Content Auditseranking/seo-skills160—~3kAutomated safety check: PassMIT
Content BriefInfrasity-Labs/dev-gtm-claude-skills139—~2.8kAutomated safety check: PassMIT
SEO Geoericrisco/rsc-harness167—~2.8kAutomated safety check: PassMIT
AI Content Auditmohitagw15856/pm-claude-skills1.4k—~1.5kAutomated safety check: PassMIT
Traction SEO Contenthashgraph-online/awesome-codex-plugins1.2k—~587Automated safety check: PassMIT

Similar skills

  • SEO Content Audit

    seranking/seo-skills

    E-E-A-T + CITE quality audit for an EXISTING piece of content.

    160 GitHub stars~3k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Content Brief

    Infrasity-Labs/dev-gtm-claude-skills

    Generates a fully structured SEO content brief for a target keyword and optionally pushes it to a Notion database.

    139 GitHub stars~2.8k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • SEO Geo

    ericrisco/rsc-harness

    A skill your agent uses when one existing page needs to rank in Google AND get cited by AI answer engines — auditing a URL for on-page SEO, structured-data JSON-LD, GEO citation levers, Core Web…

    167 GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • AI Content Audit

    mohitagw15856/pm-claude-skills

    Audit a content library, docs site, or blog for AI-generated filler that's eroding trust and search performance — and triage what to fix, rewrite, or delete.

    1.4k GitHub stars~1.5k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Traction SEO Content

    hashgraph-online/awesome-codex-plugins

    Plan SEO and content marketing traction experiments from Traction.

    1.2k GitHub stars~587 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • 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

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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    Auto-check passed

Categories

Questions about SEO Content Gap Audit

What does SEO Content Gap Audit do?

Audit content gaps and decay using Ahrefs MCP data: missing topics, thin coverage, outdated content, and decaying pages. SEO Content Gap Audit is an agent skill from rampstackco/claude-skills. Audit content gaps and decay using Ahrefs MCP data: missing topics, thin coverage, outdated content, and decaying pages.

When should I use SEO Content Gap Audit?

SEO Content Gap Audit fits situations like: planning a content roadmap; refreshing a stale catalog; building topical authority; identifying which existing pages need update versus replacement.

How do I install SEO Content Gap Audit in Claude Code?

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

How do I install SEO Content Gap Audit in Codex?

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

Can I use SEO Content 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-content-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-content-gap-audit, .gemini/skills/seo-content-gap-audit, .github/skills/seo-content-gap-audit and .opencode/skills/seo-content-gap-audit in your project.

What does SEO Content Gap Audit need to run?

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

Does SEO Content 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 Content 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 Content Gap Audit use?

SEO Content 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 Content Gap Audit use?

About 2.3k tokens (SKILL.md is roughly 9.1k 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.9k tokens, read only when the agent opens those files.

What are the alternatives to SEO Content Gap Audit?

Skills that share tags, products or a category with SEO Content Gap Audit: SEO Content Audit (seranking/seo-skills, 160 stars), Content Brief (Infrasity-Labs/dev-gtm-claude-skills, 139 stars), SEO Geo (ericrisco/rsc-harness, 167 stars) and AI Content Audit (mohitagw15856/pm-claude-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Content 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.