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.
63
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/seo-content-gap-audit/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly articulates specific capabilities (auditing content gaps, decay, thin coverage, outdated pages), specifies the data source (Ahrefs MCP), and provides comprehensive trigger guidance with both use-case scenarios and explicit keyword triggers. The description is well-structured, uses third person voice appropriately, and includes a creative situational trigger ('organic traffic is flat despite consistent publishing') that captures a real user pain point.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: audit content gaps, identify missing topics, thin coverage, outdated content, decaying pages, and determine update versus replacement. Also specifies the data source (Ahrefs MCP data). | 3 / 3 |
Completeness | Clearly answers both 'what' (audit content gaps and decay using Ahrefs MCP data across multiple dimensions) and 'when' (explicit 'Use this skill when...' clause plus a detailed 'Triggers on' list covering numerous scenarios). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'content gap', 'content audit', 'content refresh', 'content roadmap', 'decaying content', 'topical authority', 'what topics should we cover', 'where is competitor content stronger', and the situational trigger about flat organic traffic despite publishing. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: content gap/decay auditing specifically using Ahrefs MCP data. The combination of SEO content auditing, Ahrefs as the data source, and specific triggers like 'decaying content' and 'topical authority' make it unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-organized strategic skill with a clear framework (4 categories), a useful decision matrix, and comprehensive failure patterns. However, it falls short on actionability—it never shows actual Ahrefs MCP tool calls or concrete commands, making it more of a conceptual guide than an executable skill. The referenced bundle file doesn't exist, and the workflow lacks validation checkpoints for what is essentially a multi-step audit with consequential actions.
Suggestions
Add concrete Ahrefs MCP tool call examples (e.g., specific function names, parameters, and expected response structures) for each data-pull step in the workflow.
Add validation checkpoints to the workflow, such as 'Verify inventory completeness: confirm all URLs have organic click data before proceeding to classification' and 'Cross-check classification counts against total inventory to ensure no pages are unclassified.'
Create the referenced `references/content-decision-matrix.md` bundle file, or remove the reference and expand the inline decision matrix with worked examples.
Trim the failure patterns section to the 4-5 most critical anti-patterns and reduce the framework preamble about Similarweb/Semrush to a single sentence, since the skill is focused on Ahrefs MCP.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some unnecessary verbosity. The 'When to use' / 'When NOT to use' sections are helpful but could be tighter. The multi-paragraph explanation of Similarweb/Semrush in the framework section adds context Claude doesn't need for execution. The failure patterns section, while useful, is lengthy and some items are common-sense for Claude. | 2 / 3 |
Actionability | The skill provides a clear framework and decision matrix, but lacks concrete executable guidance. There are no specific Ahrefs MCP tool calls, API commands, or code examples showing how to actually pull the data. It describes what to pull (e.g., 'Ahrefs Content Explorer', 'competitor top pages') but never shows the actual MCP function calls or parameters needed to execute the workflow. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced and logically ordered, but lacks validation checkpoints. There's no explicit verification step after pulling inventory data, no check that competitor data is complete before classification, and no feedback loop for when classification is ambiguous. For an audit involving potentially destructive actions (prune, redirect), the absence of validation gates is a notable gap. | 2 / 3 |
Progressive Disclosure | The skill references one external file (references/content-decision-matrix.md) and cross-references other skills appropriately in the 'When NOT to use' section. However, the bundle has no files, so the referenced content-decision-matrix.md doesn't exist. The inline action decision matrix partially compensates, but the content is somewhat monolithic—the framework categories, failure patterns, and output format sections could benefit from being split or the main body trimmed with references to supporting files. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8e70d03
Table of Contents
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.