Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rampstackco/claude-skills --skill seo-backlink-audit -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/seo-backlink-audit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-backlink-audit/

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

Similar skills

All skills for SEO and GEO →

From the same set102

The whole set →
seo-site-health-audit The seo-site-health-audit skill reranks crawler results (Ahrefs, similar tools) by actual impact on rankings instead of issue count. It helps you decide which technical fixes to tackle first when dev time is limited. CX Codex +1 291installs seo-traffic-diagnosis seo-traffic-diagnosis diagnoses drops, stalls, or sudden spikes in organic search traffic using Ahrefs MCP, Search Console, and site analytics. CX Codex +1 290installs lead-magnet-design lead-magnet-design — a growth methodology skill to structure gated offers, checklists, and templates that qualify audience interest before collecting emails. CX Codex +1 289installs programmatic-seo Architect durable programmatic SEO systems from structured data without triggering search engine thin-content penalties. CX Codex +1 289installs seo-audit-orchestration seo-audit-orchestration runs a full SEO audit through Ahrefs MCP, coordinates focused checks, and turns their findings into one prioritized report. CX Codex +1 287installs seo-keyword-gap-audit The seo-keyword-gap-audit skill compares your site's organic footprint against competitors and flags keywords they rank for that you don't. Use it to plan content investment, spot quick wins, or scope market entry. CX Codex +1 287installs ai-content-collaboration ai-content-collaboration — a workflow guide for teams using AI in content production, with clear boundaries between model-assisted tasks and editorial decisions. CX Codex +1 287installs pm-spec-writing pm-spec-writing converts vague ideas and requests into clear briefs, PRDs, and bug reports that developers can build from. Clarifies what needs building before code starts. CX Codex +1 286installs

Project sponsors

Companies that keep this analytics open