seo-backlink-audit — Claude Code skill: analyze your link profile
seo-backlink-audit reviews backlink quality via Ahrefs MCP: whether your profile is healthy, which links are risky, what you've lost, and how you stack against rivals.
MIT 288 installs ★ 1,107 updated 2026-10-19
npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a claude-codeWhat seo-backlink-audit does
The skill examines backlink health across five dimensions: referring domain quality (Domain Rating, topical fit), link velocity (gains and losses over time), anchor text mix (branded, generic, exact-match), link types (editorial vs. directory vs. footer), and competitive gap analysis. Data comes from Ahrefs MCP, so you'll need that integration active.
It produces a risk summary (velocity spikes, low-quality domain clusters, suspect TLDs), a disavow-ready file if toxic links exist, a list of recoverable lost links with contact paths, and the top 50 domains linking to competitors but not to you. Output includes a health verdict and three chief risks plus three opportunities.
Not for building new links (seo-offpage does that), general SEO audits (seo-audit-orchestration), or keyword gaps. Won't run without Ahrefs MCP.
What it helps with
- assess backlink quality and spot risky or toxic links
- prepare a disavow file after a Google penalty or unnatural link warning
- identify lost links and prioritize them for outreach recovery
- find domains that link to competitors but not to you
- evaluate link equity during M&A due diligence
Example prompts for the agent
- Audit the backlink profile of example.com against competitor blogs over the last 12 months
- Compile lost links for domain.ru from the past three months and show me who to contact for reclamation
- Identify toxic links on our domain and generate a disavow file
How to install seo-backlink-audit
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a claude-code2Manually: put the files in place
~/.claude/skills/seo-backlink-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-backlink-audit/
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a codex2Manually: put the files in place
.agents/skills/seo-backlink-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a cursor2Manually: put the files in place
.cursor/skills/seo-backlink-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rampstackco/claude-skills skills/seo-backlink-audit2Manually: put the files in place
.github/skills/seo-backlink-audit/SKILL.md1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/rampstackco/claude-skills --path skills/seo-backlink-auditManually: put the files in place
.devin/skills/seo-backlink-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about seo-backlink-audit
How do I install seo-backlink-audit in Claude Code?
Run npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a claude-code. Then open ~/.claude/skills/seo-backlink-audit/SKILL.md and confirm the Ahrefs MCP integration is connected.
What do I need to provide before running an audit?
Specify a target domain, a set of 3–5 competitor domains with similar SEO strategy, a time window (typically 12–24 months), and verify Ahrefs MCP access. Share any manual action status from Search Console if one exists.
Do I need to disavow links after this audit?
Only after a manual action or if the skill flags clear spam signals. Most profiles don't need a disavow—removing legitimate links can hurt rankings. The skill will tell you whether it's warranted.
Source text
SKILL.md · MIT
---
name: seo-backlink-audit
description: "Audit a backlink profile using Ahrefs MCP data: profile health, anchor text distribution, toxic link identification, lost link reclamation, and gap analysis against competitors. Use this skill when reviewing backlink health, scoping a disavow project, recovering from a manual action, planning link building, or doing M&A due diligence on a property's link equity. Triggers on backlink audit, link profile, toxic links, disavow, anchor text analysis, lost links, link reclamation, referring domains, link gap. Also triggers when traffic decline correlates with link loss or when an unnatural link warning appears in Search Console."
category: seo-audit-suite
catalog_summary: "Profile health, anchor mix, toxic links, reclamation, gap analysis"
display_order: 2
---
# SEO Backlink Audit
Audit a backlink profile using data pulled from the Ahrefs MCP. Stack-agnostic. Produces a profile health assessment, a toxic link list (if needed), a reclamation list, and a gap analysis against competitors.
---
## When to use
- Periodic backlink health check (quarterly or biannual)
- Recovering from a Google manual action or unnatural link warning
- Scoping a disavow file
- Pre-acquisition due diligence on link equity
- Planning a link building campaign (need a baseline)
- Investigating ranking drops correlated with link loss
- Recovering lost links after a migration or replatform
## When NOT to use
- Building new links (use `seo-offpage`)
- General SEO audits (use `seo-audit-orchestration`)
- Keyword opportunity analysis (use `seo-keyword-gap-audit`)
- Technical issues unrelated to links (use `seo-site-health-audit`)
---
## Required inputs
- Target property (root domain, subdomain, or URL prefix)
- Competitor set (3-5 properties with comparable strategies)
- Time window (typically last 12-24 months)
- Confirmation Ahrefs MCP is connected and has access to the property
- Search Console manual action status (if any)
- Recent SEO history (migrations, link campaigns, penalties)
---
## The framework: 5 dimensions of a backlink profile
A profile is healthy when all five dimensions are healthy. Issues in any one can cap rankings or invite penalties.
### Dimension 1: Referring domain quality
Volume of links matters less than the quality and relevance of the linking domains.
Pull from Ahrefs:
- Total referring domains (current and trended)
- Domain Rating distribution (DR bands)
- Topical relevance of linking domains
- Geographic distribution (where appropriate)
- Domain age and trust signals
Healthy signal: a long tail of relevant, established domains. Concentration in any single source is a risk.
### Dimension 2: Link velocity
How fast links are gained or lost.
Pull from Ahrefs:
- New referring domains per month (trended 12-24 months)
- Lost referring domains per month
- Net change
Healthy signal: steady positive growth. Sudden spikes suggest paid campaigns or negative SEO. Sudden drops correlate with redirect mistakes, content removal, or the linking sites going down.
### Dimension 3: Anchor text distribution
The mix of anchor types tells search engines what the property is about and whether the profile looks natural.
Categories to map:
- Branded (the brand name)
- Naked URL
- Generic ("click here", "this page")
- Exact-match keyword
- Partial-match keyword
- Image (alt text or none)
Healthy signal: branded and naked URL anchors dominate. Exact-match keyword anchors are a small minority. Heavy exact-match concentration triggers spam filters.
### Dimension 4: Link types
Not all links are equal.
Categories:
- Dofollow versus nofollow
- Editorial versus directory or comment
- In-content versus footer or sidebar
- Sponsored or UGC tagged
- Redirect chains
- Lost links recoverable via outreach
Healthy signal: editorial in-content dofollow links from relevant sites dominate.
### Dimension 5: Competitive gap
What links do peers have that you do not?
Pull from Ahrefs:
- Domains linking to 2+ competitors but not the target
- Domains linking to 1 competitor with high relevance to the target
- Top performing competitor pages by referring domain count
Healthy signal: the gap is shrinking over time. A widening gap is a strategic risk.
---
## Workflow
1. **Charter the audit.** Goal, scope, time window, competitor set.
2. **Pull baseline data.** Referring domains, anchor text, link types, lost links, competitor overlap.
3. **Map the profile across 5 dimensions.** One section per dimension.
4. **Identify red flags.** Velocity spikes, anchor concentration, low-DR concentration, suspect TLDs, repeated footprints.
5. **Build the toxic list (if needed).** Use the criteria in [`references/toxic-link-criteria.md`](references/toxic-link-criteria.md).
6. **Build the reclamation list.** Lost links worth recovering via outreach.
7. **Build the gap list.** Domains linking to peers, prioritized by relevance.
8. **Synthesize.** Profile health verdict, top 3 risks, top 3 opportunities.
9. **Recommend.** Disavow (rare), reclamation outreach, link building targets, monitoring cadence.
10. **Document and hand off.** Outputs feed `seo-offpage` and `seo-audit-orchestration`.
---
## Failure patterns
- **Disavow happy.** Most profiles do not need a disavow. Disavowing legitimate links damages rankings. Use it only after a manual action or clear algorithmic signals.
- **Counting links instead of evaluating them.** A profile with 10,000 referring domains can be weaker than one with 200 high-quality editorial links.
- **Ignoring lost links.** Recovering a lost link is faster and cheaper than building a new one.
- **No competitor benchmark.** Profile health is relative. A "low" backlink count for a tier-1 competitor is a "great" count for a niche site.
- **Anchor text panic.** A high exact-match percentage in absolute terms is fine for niche sites where the brand and keyword overlap. Investigate before disavowing.
- **One-time audit.** Profile health drifts. Audit on a cadence (quarterly minimum for active properties).
- **Treating Ahrefs as ground truth.** Ahrefs sees most links but not all. Triangulate with Search Console for completeness.
- **Over-indexing on Domain Rating.** DR is a relative metric, not a quality signal. A DR-30 niche site can be more valuable than a DR-80 generalist.
---
## Output format
A backlink audit document with:
1. **Executive summary.** Profile health verdict and top risks.
2. **Profile snapshot.** Key metrics: referring domains, DR distribution, anchor mix, velocity, or state the gap per the data-availability rule.
3. **5-dimension analysis.** One section per dimension with findings.
4. **Toxic link list.** If needed. Disavow file ready format.
5. **Reclamation list.** Lost links worth recovering, with contact paths.
6. **Gap list.** Top 50 domains linking to competitors but not target.
7. **Recommendations.** Disavow (Y/N), reclamation outreach plan, link building targets.
8. **Methodology.** Data sources, pull dates, criteria used.
Length: 8-15 pages depending on profile complexity.
---
## 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
- [`references/toxic-link-criteria.md`](references/toxic-link-criteria.md) - Decision framework for classifying a link as toxic, including the disavow file format and threshold guidance.
© rampstackco · MIT · rampstackco/claude-skills