Ahrefs agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Ahrefs work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Ahrefs

Connect Ahrefs once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Ahrefs skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereRead-only24 Ahrefs tools

Ahrefs connector essentials

Connects your Ahrefs account to your AI assistant so it can query keywords, brand visibility, projects and crawler data. It confirms your workspace, country and plan first, and it does not change anything in your account without your approval.

Use it when

You have just connected Ahrefs and want to know what the assistant can see.
You are not sure whether a question belongs to keyword research, brand visibility or project tracking.
An Ahrefs query returned a limit, a permission error or an empty result and you need to know why.

Tools it uses

keywords-explorer-overview
keywords-explorer-matching-terms
keywords-explorer-related-terms
keywords-explorer-search-suggestions
keywords-explorer-volume-by-country
keywords-explorer-volume-history
brand-radar-ai-responses
brand-radar-cited-domains
brand-radar-cited-pages
brand-radar-mentions-overview
brand-radar-mentions-history
brand-radar-impressions-overview
brand-radar-impressions-history
brand-radar-sov-overview
brand-radar-sov-history
management-projects
management-project-keywords
management-project-competitors
management-keyword-list-keywords
management-locations
public-crawler-ip-ranges
public-crawler-ips
batch-analysis
doc

Example

Connect to Ahrefs and tell me which country and workspace my keyword data comes from before you pull any numbers.

Your connection is to the Ahrefs workspace Acme Growth on the Standard plan. Volume figures will be for the United States unless you tell me otherwise. I have not changed anything in your projects.

Use in RevampKeyRead the full skill →

Read-only9 Ahrefs tools

Audit your brand's visibility in AI answers with Ahrefs

Checks how your brand is named, cited and described in AI-generated answers using Ahrefs Brand Radar, and shows whether share of voice is rising or falling against competitors. It reads the data and does not change any tracking setup without asking first.

Use it when

You want to know if ChatGPT or Perplexity names your brand when people ask about your category
Competitors get cited in AI answers and you want to find out why
You need a share of voice trend for AI search to report to leadership

Tools it uses

brand-radar-mentions-overview
brand-radar-impressions-overview
brand-radar-sov-overview
brand-radar-mentions-history
brand-radar-impressions-history
brand-radar-sov-history
brand-radar-cited-domains
brand-radar-cited-pages
brand-radar-ai-responses

Example

How visible is our brand in AI answers compared with our three main competitors over the last quarter?

Your brand was mentioned in 412 AI answers this quarter, and share of voice rose from 18% to 21% while Competitor A fell from 30% to 27%. The clearest gap is a comparison prompt where Competitor A is cited from a review site you are not listed on. I have not changed any tracked brands or aliases; say the word if you want me to suggest adding the product name 'Acme Pro' to the tracked set.

Use in RevampKeyRead the full skill →

Read-only2 Ahrefs tools

Check that Ahrefs crawling is not blocked

Checks whether Ahrefs' published crawler IPs and ranges are admitted by your firewall, WAF, bot management or robots.txt rules. It drafts the allowlist and asks before any rule is changed.

Use it when

Ahrefs reports crawl errors or blocked pages on your site
You need the IP ranges to allowlist in a firewall or WAF
You want to confirm a bot management rule is not blocking AhrefsBot

Tools it uses

public-crawler-ips
public-crawler-ip-ranges

Example

Is Ahrefs allowed through our firewall? Check our rules against the current crawler IP ranges.

I fetched the current Ahrefs crawler IP ranges and compared them with the rule you pasted. The WAF allowlist covers 2 of the 3 published ranges, so one block of crawler traffic is being dropped. I've drafted the missing CIDR block for you to review. I have not changed anything; tell me if you want me to proceed.

Use in RevampKeyRead the full skill →

Read-only6 Ahrefs tools

Keyword research brief with Ahrefs

Turns a seed topic or product into a prioritised keyword set grouped into clusters, each with search intent and volume guidance, using Ahrefs Keywords Explorer. It asks for your market and goal first and does not change any project data.

Use it when

You are planning content for a new product or category
You need to know which terms are worth targeting for a topic
You want keyword clusters with intent labels for a content calendar

Tools it uses

keywords-explorer-overview
keywords-explorer-matching-terms
keywords-explorer-related-terms
keywords-explorer-search-suggestions
keywords-explorer-volume-history
keywords-explorer-volume-by-country

Example

Build a keyword research brief for project management software for small construction firms in the UK.

From 340 candidates I kept 58 after removing job-seeker and unrelated-industry terms. They form 6 clusters. The top priority is 'construction project management software' (about 1,900 searches a month, commercial intent), with 'construction scheduling app' as a supporting term. Volume for 'how to plan a construction project' is steady but informational, so it fits a guide rather than a sales page.

Use in RevampKeyRead the full skill →

Read-only5 Ahrefs tools

Review your Ahrefs project keyword tracking

Audits an existing Ahrefs rank tracking project for stale, duplicate or misplaced keywords and outdated competitors, then proposes a cleanup. It asks before changing anything.

Use it when

You want to tidy up a project that has grown messy over several campaigns.
You suspect duplicate or outdated keywords are cluttering your tracking.
You need to check whether your competitor list still matches your market.

Tools it uses

management-projects
management-locations
management-project-competitors
management-project-keywords
management-keyword-list-keywords

Example

Review my Ahrefs project for the main site and tell me what to clean up in the tracked keywords and competitors.

I found 44 tracked keywords across 2 locations and 3 competitors. Six keywords are exact duplicates, and two are tracked in the US even though you only ship to the UK. One competitor looks acquired. I have not changed anything. Tell me which of these to remove or move and I'll list the exact changes for your approval first.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Ahrefs, updates them for you and removes them when you disconnect.

Download RevampKey

How Ahrefs skills work

Connect Ahrefs
The Ahrefs MCP server gives the agent its tools.
Ask in plain words
“How visible is our brand in AI answers compared with our three main competitors over the last quarter?” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Ahrefs skills

In RevampKey the skills install themselves when you connect Ahrefs. In other tools each skill is one folder with a SKILL.md file, and you also need the Ahrefs MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Ahrefs. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “How visible is our brand in AI answers compared with our three main competitors over the last quarter?”
Download RevampKeyConnect Ahrefs · 1 click
Get RevampKey to connect Ahrefs
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Ahrefs is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials brand-visibility-audit crawler-access-check keyword-research-brief project-keyword-tracking-review; do curl -fsSL --create-dirs -o .claude/skills/ahrefs-$s/SKILL.md https://revampkey.com/marketplace/ahrefs/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Ahrefs MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

for s in essentials brand-visibility-audit crawler-access-check keyword-research-brief project-keyword-tracking-review; do
  curl -fsSL --create-dirs -o .claude/skills/ahrefs-$s/SKILL.md https://revampkey.com/marketplace/ahrefs/skills/$s/SKILL.md
done

Ask in plain language, for example “How visible is our brand in AI answers compared with our three main competitors over the last quarter?”

Into the shared .agents/skills folder

Connect the Ahrefs MCP server in Cursor.

Run this in your project folder to add all 5 skills:

for s in essentials brand-visibility-audit crawler-access-check keyword-research-brief project-keyword-tracking-review; do
  curl -fsSL --create-dirs -o .agents/skills/ahrefs-$s/SKILL.md https://revampkey.com/marketplace/ahrefs/skills/$s/SKILL.md
done

Ask in plain language, for example “How visible is our brand in AI answers compared with our three main competitors over the last quarter?”

Into the shared .agents/skills folder

Connect the Ahrefs MCP server in Codex.

Run this in your project folder to add all 5 skills:

for s in essentials brand-visibility-audit crawler-access-check keyword-research-brief project-keyword-tracking-review; do
  curl -fsSL --create-dirs -o .agents/skills/ahrefs-$s/SKILL.md https://revampkey.com/marketplace/ahrefs/skills/$s/SKILL.md
done

Ask in plain language, for example “How visible is our brand in AI answers compared with our three main competitors over the last quarter?”

Into the shared .agents/skills folder

Connect the Ahrefs MCP server in VS Code.

Run this in your project folder to add all 5 skills:

for s in essentials brand-visibility-audit crawler-access-check keyword-research-brief project-keyword-tracking-review; do
  curl -fsSL --create-dirs -o .agents/skills/ahrefs-$s/SKILL.md https://revampkey.com/marketplace/ahrefs/skills/$s/SKILL.md
done

Ask in plain language, for example “How visible is our brand in AI answers compared with our three main competitors over the last quarter?”

RevampKey or copy the files?

In RevampKey

One click when you connect Ahrefs
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Ahrefs MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Ahrefs skills FAQ

What is a Ahrefs agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Ahrefs skill describes one job, which Ahrefs tools to use in which order, what to check first and when to stop and ask you.

Do the Ahrefs skills change anything on their own?

5 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Ahrefs.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Ahrefs; elsewhere you copy the folders into your project or skills directory.

Do I need the Ahrefs MCP server too?

Yes. The skills tell the agent how to do the work; the Ahrefs MCP server gives it the tools to do it. The Ahrefs MCP setup guide covers every client.

Ahrefs MCP server setup · This page as Markdown

Put Ahrefs’s best workflows in your agent

Download RevampKey, connect Ahrefs and ask your first question in about a minute.

Download RevampKey Connect Ahrefs · 1 click

All 5 Ahrefs skills

Ahrefs connector essentials

Use it when

Tools it uses

Audit your brand's visibility in AI answers with Ahrefs

Use it when

Tools it uses

Check that Ahrefs crawling is not blocked

Use it when

Tools it uses

Keyword research brief with Ahrefs

Use it when

Tools it uses

Review your Ahrefs project keyword tracking

Use it when

Tools it uses

Get all 5 without copying a file

How Ahrefs skills work

How to install Ahrefs skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Ahrefs skills FAQ

Put Ahrefs’s best workflows in your agent

Skills for related tools