backlink-analysis — Claude Code skill: audit your link profile
Walks through a backlink profile: donor quality, toxic links, gaps against competitors. Useful when organic traffic drops or before buying links.
npx skills add kostja94/marketing-skills --skill backlink-analysis -a claude-codeWhat backlink-analysis does
The skill runs an off-page SEO audit step by step. It first asks for the domain, which SEO tools you have (Ahrefs, Semrush or free alternatives) and the goal — finding issues, comparing with competitors, or planning growth. Then it works through the metrics: referring domains, total backlinks, DR or DA, anchor text distribution, link velocity.
Quality gets judged on four things: whether donors sit in a related niche, how trusted they are, whether the link is editorial or footer/sidebar, and how natural the anchor looks. Risk signals are checked separately — toxic links, spammy anchors, link schemes, a sudden spike — each with a suggested action, up to disavow. The skill advises building a disavow file only for a manual penalty or clear toxicity, and warns that over-disavowing backfires. Submission goes through Google Search Console.
You end up with a profile summary, a quality breakdown, a list of suspicious links, link building priorities and the gaps where competitors get links you don't. Buying new links is a different job — that's the link-building skill.
What it helps with
- figure out why organic traffic dropped
- separate toxic links from harmless ones
- compare your profile against a competitor's
- find sites that link to competitors but not to you
- decide whether a disavow file is needed and what goes in it
Example prompts for the agent
- analyze the backlink profile for example.com and flag toxic links
- compare my link profile with competitors and find the gaps
- should I prepare a disavow file for this domain?
How to install backlink-analysis
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill backlink-analysis -a claude-code2Manually: put the files in place
~/.claude/skills/backlink-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/backlink-analysis/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill backlink-analysis -a codex2Manually: put the files in place
.agents/skills/backlink-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill backlink-analysis -a cursor2Manually: put the files in place
.cursor/skills/backlink-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kostja94/marketing-skills backlink-analysis2Manually: put the files in place
.github/skills/backlink-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill backlink-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/kostja94/marketing-skills --path skills/seo/off-page/backlink-analysisManually: put the files in place
.devin/skills/backlink-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill backlink-analysis -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 backlink-analysis
How do I install backlink-analysis in Claude?
Run npx skills add kostja94/marketing-skills --skill backlink-analysis -a claude-code. The skill lands in ~/.claude/skills/backlink-analysis/SKILL.md.
What does backlink-analysis do?
It audits a backlink profile: pulls the key metrics, scores donor quality, flags toxic links and risk signals, compares against competitors and returns recommendations.
How is backlink-analysis different from link-building?
This skill examines links you already have and looks for problems. Acquiring new links is handled by link-building.
Source text
SKILL.md · MIT
--- name: backlink-analysis description: When the user wants to analyze backlinks, audit link profile, or identify link issues. Also use when the user mentions "backlink analysis," "backlink audit," "referring domains," "toxic links," "link profile," or "disavow file." For acquisition, use link-building. metadata: version: 1.0.1 --- # SEO Off-Page: Backlink Analysis Guides backlink profile analysis: assessing quality, identifying issues, and planning improvements. **When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. ## Scope (Off-Page SEO) - **Backlink audit**: Analyze profile; toxic links; competitive analysis - **Authority Score**: Monitor domain/page authority; referring domains ## Initial Assessment Identify: 1. **Domain**: Site to analyze 2. **Tool access**: SEO tools (e.g. Ahrefs, Semrush) or free alternatives 3. **Goals**: Audit for issues, competitive analysis, or growth planning ## Key Metrics | Metric | Meaning | |--------|---------| | **Referring domains** | Number of unique sites linking | | **Backlinks** | Total number of links | | **Domain Rating (DR) / Domain Authority (DA)** | Domain strength score | | **Anchor text distribution** | Mix of branded, generic, exact match | | **Link velocity** | Rate of new links over time | ## Analysis Framework ### 1. Quality Assessment - **Relevance**: Do links come from related niches? - **Authority**: Are referring domains trusted? - **Context**: Editorial vs. footer/sidebar links? - **Anchor text**: Natural or over-optimized? ### 2. Risk Signals | Signal | Action | |--------|--------| | **Toxic links** | Consider disavow (use cautiously) | | **Spammy anchors** | Diversify anchor text naturally | | **Link schemes** | Remove or disavow | | **Sudden spike** | Investigate; may trigger penalty | ### 3. Competitive Comparison - Compare backlink profile to competitors - Identify link gaps (sites linking to competitors but not you) - Find link opportunities from competitor backlinks - See **competitor-research** for full methodology ## Disavow File - Use only when necessary (manual penalty, toxic links) - Submit via Google Search Console (see **google-search-console** for Links report and disavow submission) - **Caution**: Over-disavowing can harm; use sparingly - **References**: [Google Disavow](https://developers.google.com/search/docs/crawling-indexing/block-indexing#disavow-links) ## Output Format - **Profile summary**: Key metrics, trends - **Quality assessment**: Strengths and weaknesses - **Risk signals**: Toxic or suspicious links - **Recommendations**: Link building priorities, disavow if needed - **Competitive insights**: Link gap opportunities ## Related Skills - **google-search-console**: Links report, disavow file submission - **seo-monitoring**: Backlink metrics in full SEO monitoring; quality vs quantity, referral ROI - **link-building**: Use analysis to plan link building - **competitor-research**: Competitor backlink analysis; link gap methodology
© kostja94 · MIT · kostja94/marketing-skills