seo-content-gap-audit

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.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

87%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, lean, and highly actionable audit skill body with good progressive disclosure via a real reference file. The one gap is that the batch workflow lacks an explicit validation/feedback checkpoint, which caps workflow clarity.

Suggestions

Add an explicit validation step to the workflow (e.g. after step 4 'Classify each existing page', insert a checkpoint to review/confirm classifications against the decision matrix before scoring and deciding actions), to satisfy the batch-operation validation requirement.

Include a short feedback loop for the most error-prone step — e.g. 'if a page fits multiple categories, re-classify using the first-match-wins rule in references/content-decision-matrix.md' — so misclassifications are caught before roadmap sequencing.

State the data-availability gate as an explicit early workflow checkpoint (verify Ahrefs MCP is connected and required inputs are present before pulling inventory) rather than only in the trailing 'If required data is unavailable' section.

Dimension	Reasoning	Score
Conciseness	The body is dense and information-rich with no padding of basic concepts Claude already knows; every section (framework, matrix, failure patterns, output spec) earns its place, matching the lean level-5 anchor.	5 / 5
Actionability	Provides concrete, specific guidance per category (e.g. "Pages ranking on page 2-3", "Pages with publish dates over 18 months old"), a signal-to-action decision matrix, and a referenced worked decision tree covering common cases, matching the fully-executable level-5 anchor for an instruction skill.	5 / 5
Workflow Clarity	The 10-step workflow is clearly sequenced, but this is a batch audit operation and the main workflow lacks an explicit validation/feedback checkpoint (e.g. validate classifications before deciding actions); per the rubric's batch-operation cap, workflow clarity cannot exceed 3.	3 / 5
Progressive Disclosure	A clear overview with one well-signaled one-level-deep reference (references/content-decision-matrix.md, verified to exist and hold the detailed decision tree, worked examples, and effort cheat sheet), with the framework kept inline and detail delegated, matching the level-5 anchor.	5 / 5
	Total	18 / 20 Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states what the skill does and when to use it, with comprehensive natural trigger phrases. Its only weakness is that it does not embed the sibling-skill disambiguation present in the body, leaving slight overlap risk.

Dimension	Reasoning	Score
Specificity	Names concrete capabilities ("Audit content gaps and decay using Ahrefs MCP data") and enumerates the four gap categories, but presents domain categories rather than a comprehensive list of discrete operations, so it sits below the level-5 anchor.	4 / 5
Completeness	Explicitly answers both what ("Audit content gaps and decay using Ahrefs MCP data") and when ("Use this skill when..." plus a concrete "Triggers on..." list), matching the level-5 anchor for explicit what-and-when with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural-term coverage including synonyms ("decaying content" / "content decay") and full-sentence queries users would actually say ("what topics should we cover", "where is competitor content stronger"), matching the level-5 anchor.	5 / 5
Distinctiveness Conflict Risk	The Ahrefs content-gap/decay niche is mostly distinct, but the description does not disambiguate from closely related sibling skills (seo-keyword, seo-keyword-gap-audit, seo-content-audit) that the body calls out, leaving minor overlap risk rather than the minimal risk of the level-5 anchor.	4 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: rampstackco/claude-skills
Path: skills/seo-content-gap-audit/SKILL.md
Commit: a67dd34

Reviewed: 7 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.