Agent skill

Ahrefs Tool

by garrettjsmith in garrettjsmith/localseoskills

When the user wants backlink analysis, link gap analysis, competitor link profiles, referring domain data, or link building research.

MITAuto-check passedMarketing & SEO

Install Ahrefs Tool

skills CLI
$ npx skills add garrettjsmith/localseoskills --skill ahrefs-tool -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install garrettjsmith/localseoskills ahrefs-tool --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ahrefs-tool .claude/skills/ahrefs-tool && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ahrefs-tool
GitHub stars
114
Token cost
~1.7k tokens
SKILL.md length
867 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

When the user wants backlink analysis, link gap analysis, competitor link profiles, referring domain data, or link building research.

  • Works in 4 steps: Domain Rating (DR): Overall link… → Referring Domains: Unique domains… → Backlink list: Individual backlinks with… → …
  • Wants backlink analysis
  • SKILL.md covers When to Use Ahrefs vs Other…, Core Workflows, Key Metrics and What They Mean and What to Do Next
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ahrefs Tool is an agent skill from garrettjsmith/localseoskills. When the user wants backlink analysis, link gap analysis, competitor link profiles, referring domain data, or link building research. Trigger on "backlinks," "who links to," "link profile," "referring domains," "link gap," "Ahrefs," "link building research," or "why do they outrank me" (often a link authority issue).

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Link building. It works with Ahrefs. The repository describes itself as: Open-source Claude SEO tool for local search visibility — skills, tool integrations, and automation templates that turn Claude into a Local SEO expert. The licence is MIT.

When your agent uses it

  • Wants backlink analysis
  • Link gap analysis
  • Competitor link profiles
  • Referring domain data

Example prompts

  • “backlinks,”
  • “who links to,”
  • “link profile,”
  • “/ahrefs-tool”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Domain Rating (DR): Overall link authority score (0-100)
  2. Referring Domains: Unique domains linking to the site (more important than total backlinks)
  3. Backlink list: Individual backlinks with source, anchor text, follow/nofollow, first seen date
  4. Referring domains by DR: Quality distribution of linking domains

What it can do on your machine

Read from SKILL.md and the folder at commit 405ce20. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ahrefs Tool loads about 1.7k tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 867 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from garrettjsmith/localseoskills at commit 405ce20, republished under its MIT licence (© garrettjsmith). 867 words, ~1,734 tokens.

Download SKILL.mdSave it as .claude/skills/ahrefs-tool/SKILL.md (or your agent's skills folder).
name
ahrefs-tool
description
When the user wants backlink analysis, link gap analysis, competitor link profiles, referring domain data, or link building research. Trigger on "backlinks," "who links to," "link profile," "referring domains," "link gap," "Ahrefs," "link building research," or "why do they outrank me" (often a link authority issue).
metadata.version
1.0.0
metadata.author
Garrett Smith

Ahrefs Tool

Note: LocalSEOData (localseodata-tool) now has backlink_summary and backlink_gap endpoints. Use LocalSEOData for quick backlink overviews and gap analysis. Ahrefs remains the preferred tool for deep link analysis — anchor text profiles, lost/new links, referring domain details, and content gap analysis.

Ahrefs has an official MCP server. When connected, use it for backlink analysis and link-focused competitive intelligence. Ahrefs has the largest backlink index — it's the authoritative source for link data.

When to Use Ahrefs vs Other Tools

You NeedUse AhrefsUse Instead
Backlink profile for a domain✅ Best backlink database—
Referring domains count/list✅—
Link gap (who links to competitor but not you)✅ Best for this—
Lost/broken backlinks✅—
Anchor text analysis✅—
Keyword search volume⚠️ Can do itSemrush (better keyword tool)
Keyword gap analysis⚠️ Can do itSemrush (preferred for keywords)
Content Explorer (find linkable content)✅ Unique to Ahrefs—
Technical site audit⚠️ Has oneScreaming Frog (more detailed)
SERP data❌SerpAPI
Local pack rankings❌Local Falcon
Citation data❌BrightLocal

Core Workflows

When: User asks "why aren't we ranking?" or needs to understand link authority.

What to pull:

  1. Domain Rating (DR): Overall link authority score (0-100)
  2. Referring Domains: Unique domains linking to the site (more important than total backlinks)
  3. Backlink list: Individual backlinks with source, anchor text, follow/nofollow, first seen date
  4. Referring domains by DR: Quality distribution of linking domains

How to interpret for local:

  • DR 20-40: Typical for local businesses
  • DR 40-60: Strong local site, likely has press or industry links
  • DR 60+: Very strong, probably a brand or large multi-location
  • Referring domains matter more than total backlinks (10 links from 10 domains > 50 links from 2 domains)
  • Local relevance matters: 1 link from a local news site > 10 links from random blogs

Red flags:

  • Sudden spike in referring domains (could be spam or negative SEO)
  • Mostly nofollow links (limited authority transfer)
  • Anchor text heavily keyword-stuffed (penalty risk)
  • Links from irrelevant or low-quality sites

When: User wants to find link building opportunities from competitor profiles.

What to pull:

  1. Link Intersect: Domains that link to competitors but NOT to user's site
  2. Filter by DR 20+ (skip low-quality)
  3. Filter by dofollow links
  4. Sort by referring domain authority

What to look for:

  • Local directories linking to competitors but not you → citation opportunity
  • Local news/media sites → PR opportunity
  • Industry associations or organizations → membership/sponsorship opportunity
  • Local blogs or community sites → content/relationship opportunity
  • .edu or .gov sites → high authority, worth extra effort

How to prioritize opportunities:

  1. Local relevance (local site > random site)
  2. Domain authority (DR 30+ preferred)
  3. Dofollow status (dofollow > nofollow for SEO, but nofollow still has value)
  4. Achievability (directory listings are easy, editorial links take effort)

When: Rankings dropped and you suspect link loss, or routine maintenance.

What to pull:

  1. Lost backlinks (filtered by recent timeframe)
  2. Filter by referring domain DR 20+
  3. Check if the linking page is gone (404) or the link was removed

What to do:

  • Page 404'd → Reach out and ask to update the link
  • Link removed → Understand why (content changed? contact changed?)
  • Domain expired → Check if link was valuable enough to pursue alternative
  • High-DR losses → Priority recovery targets
Show full SKILL.md (330 more words)Show less
Anchor Text Analysis

When: Checking for over-optimization or understanding link profile health.

What healthy local anchor text looks like:

  • Brand name (40-60%): "Smith Plumbing," "smithplumbing.com"
  • Generic (15-25%): "click here," "website," "learn more"
  • Location-based (10-20%): "plumber in Buffalo," "Buffalo NY plumbing"
  • Exact match keywords (under 10%): "emergency plumber" — too much of this is a penalty risk
Content Explorer (Find Linkable Content Ideas)

When: User needs content ideas that attract links.

  • Search for topics in your industry + location
  • Find content that got the most links in your space
  • Analyze what made it linkable (data, tools, guides, local research)
  • Create something better for your market

Key Metrics and What They Mean

MetricWhat It IsLocal SEO Context
Domain Rating (DR)Ahrefs' authority score (0-100)Compare to local competitors, not national brands
Referring DomainsUnique domains linking to youThe #1 link metric — more unique domains = more authority
URL Rating (UR)Authority of a specific pageUseful for comparing location page authority
Dofollow %Percentage of links passing authorityBelow 50% dofollow is weak
Anchor text distributionWhat text is used in linksOver-optimized anchors can trigger penalties
Link velocityRate of new links acquiredSteady growth is healthy, spikes are suspicious

What to Do Next

What You FoundNext ActionSkill
Competitor has 3x more referring domainsBuild a link acquisition strategylocal-link-building
Found link gap opportunities (directories)These are citation opportunitieslocal-citations
Found link gap opportunities (editorial/media)Build targeted outreach campaignslocal-link-building
Anchor text over-optimizedDiversify with brand and generic anchors going forwardlocal-link-building
Lost high-value linksOutreach to recover, then build replacementslocal-link-building
Link profile is fine but still not ranking locallyLinks aren't the issue — check GBP, reviews, proximitygeogrid-analysis, gbp-optimization
Need this data in a client reportInclude link profile comparison in deliverablesclient-deliverables

Default next step: Link analysis always raises the question "is this a link problem or something else?" If the link profile is comparable to competitors, the issue is likely GBP, reviews, or relevance — not links.

© garrettjsmith, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/ahrefs-tool of garrettjsmith/localseoskills.

Open the folder on GitHubat commit 405ce20

Compare with similar skills

Ahrefs Tool next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ahrefs Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ahrefs Tool this skillgarrettjsmith/localseoskills114—~1.7kAutomated safety check: PassMIT
Global SEO Growthminhnv0807/ai-business-skills608—~5kAutomated safety check: PassMIT
Ahrefs PythonOpenClaudia/openclaudia-skills711—~1.9kAutomated safety check: PassMIT
Backlinkyan-labs/yan-skills208—~8.9kAutomated safety check: PassMIT
SEO AhrefsAgriciDaniel/claude-seo18k1 repos~611Automated safety check: PassMIT
Backlink AuditOpenClaudia/openclaudia-skills711—~3.5kAutomated safety check: NotesMIT

Similar skills

  • Global SEO Growth

    minhnv0807/ai-business-skills

    Covers six SEO layers for a website: crawl and index audit, local SEO, search-intent content, AI search visibility, schema markup and backlink or directory distribution.

    608 GitHub stars~5k tokensUpdated 26 days ago
    Marketing & SEOAuto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    711 GitHub stars~1.9k tokensUpdated 20 days ago
    Marketing & SEOAuto-check passed
  • Backlink

    yan-labs/yan-skills

    A skill your agent uses for backlink work - finding, qualifying, submitting, analyzing or verifying backlinks, directory and blog-comment placements, competitor link sources, anchors, toxic links…

    208 GitHub stars~8.9k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • SEO Ahrefs

    AgriciDaniel/claude-seo

    Ahrefs API analyst (extension). An agent skill from AgriciDaniel/claude-seo.

    18k GitHub starsUsed in 1 repo~611 tokens
    Marketing & SEOAuto-check passed
  • Backlink Audit

    OpenClaudia/openclaudia-skills

    Audit a domain's backlink profile using the SemRush API. An agent skill from OpenClaudia/openclaudia-skills.

    711 GitHub stars~3.5k tokensUpdated 20 days ago
    Marketing & SEOAuto-check: notes
  • Backlink Audit

    nowork-studio/notfair-plugin

    Backlink / off-page SEO audit. An agent skill from nowork-studio/notfair-plugin.

    3.9k GitHub stars~979 tokensUpdated 7 days ago
    Marketing & SEOAuto-check passed

More from garrettjsmith/localseoskills

All 38 skills in this repo
  • Gbp API Automation

    garrettjsmith/localseoskills

    When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems.

    114 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Gbp Posts

    garrettjsmith/localseoskills

    When the user wants to create, schedule, or optimize Google Business Profile posts.

    114 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Content Briefs

    garrettjsmith/localseoskills

    Generate complete semantic content briefs for local SEO content — location pages, service pages, blog posts, FAQ content, and pillar pages.

    114 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Brief

    garrettjsmith/localseoskills

    Manages persistent work state (briefs) for local SEO engagements.

    114 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Local Content Strategy

    garrettjsmith/localseoskills

    Build a complete local content strategy from keyword research output.

    114 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Local Falcon Tool

    garrettjsmith/localseoskills

    When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews.

    114 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Ahrefs Tool

What does Ahrefs Tool do?

When the user wants backlink analysis, link gap analysis, competitor link profiles, referring domain data, or link building research. Ahrefs Tool is an agent skill from garrettjsmith/localseoskills. When the user wants backlink analysis, link gap analysis, competitor link profiles, referring domain data, or link building research.

When should I use Ahrefs Tool?

Ahrefs Tool fits situations like: wants backlink analysis; link gap analysis; competitor link profiles; referring domain data.

How do I install Ahrefs Tool in Claude Code?

Run `npx skills add garrettjsmith/localseoskills --skill ahrefs-tool -a claude-code`. Or copy the skill folder (skills/ahrefs-tool in garrettjsmith/localseoskills) into .claude/skills/ahrefs-tool in your project. Claude Code loads it when a task matches its description.

How do I install Ahrefs Tool in Codex?

Run `npx skills add garrettjsmith/localseoskills --skill ahrefs-tool -a codex`. Or copy the skill folder (skills/ahrefs-tool in garrettjsmith/localseoskills) into .agents/skills/ahrefs-tool in your project. Codex loads it when a task matches its description.

Can I use Ahrefs Tool in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add garrettjsmith/localseoskills --skill ahrefs-tool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ahrefs-tool, .gemini/skills/ahrefs-tool, .github/skills/ahrefs-tool and .opencode/skills/ahrefs-tool in your project.

What does Ahrefs Tool need to run?

SKILL.md names no scripts, command-line tools or credentials: Ahrefs Tool is instructions for the agent only.

Does Ahrefs Tool access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ahrefs Tool safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ahrefs Tool use?

Ahrefs Tool is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ahrefs Tool use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ahrefs Tool?

Skills that share tags, products or a category with Ahrefs Tool: Global SEO Growth (minhnv0807/ai-business-skills, 608 stars), Ahrefs Python (OpenClaudia/openclaudia-skills, 711 stars), Backlink (yan-labs/yan-skills, 208 stars) and SEO Ahrefs (AgriciDaniel/claude-seo, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ahrefs Tool?

garrettjsmith (a GitHub user) maintains it in garrettjsmith/localseoskills, which has 114 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on August 15, 2026.

Source: garrettjsmith/localseoskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.