---
name: ahrefs-reference
description: Search Ahrefs blog for reference articles on a keyword
argument-hint: "[keyword]"
---

# Ahrefs Reference Skill

Search the Ahrefs blog (ahrefs.com/blog) for articles relevant to a target keyword and compile their full content into a single reference document.

## Input

**Target keyword** - The topic to search for on Ahrefs blog

---

## Workflow

### Step 1: Search Ahrefs Blog

Use WebSearch with query: `site:ahrefs.com/blog [target keyword]`

**Select up to 3 articles that are:**
- Directly relevant to the target keyword
- Educational/guide content (not news or updates)
- Comprehensive (prefer guides over short posts)

**Skip articles that are:**
- Product announcements or changelog posts
- Tangentially related topics
- Duplicate/overlapping content with another selected article

---

### Step 2: Extract Full Content

For each selected article (up to 3), use WebFetch with this prompt:
```
Extract the full article content in markdown format. Include:
1. The article title as H1
2. All H2 and H3 headers preserved
3. All body text paragraphs
4. Any numbered or bulleted lists
5. Key statistics or data points
6. Skip: navigation, ads, author bios, related posts, comments
```

---

### Step 3: Compile Reference Document

Combine all extracted articles into a single reference document with header, table of contents, and each article separated by horizontal rules.

---

## Output

Save to `./reference/[keyword-slug]-ahrefs.md`

## Example Usage

```
/ahrefs-reference "link building"
/ahrefs-reference "keyword research"
```