# blog-refresher

The blog-refresher Claude Code skill audits and revises existing blog posts. It starts when asked to update a post, investigate lost rankings, or compare its coverage with competing pages.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 842 installs · ★ 1797 repo stars
- Author: illyism
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Illyism/seo-skills/tree/HEAD/seo/blog-refresher/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/blog-refresher

## What it does

The skill reviews a post, researches pages in search results, and compares their coverage. It identifies gaps, drafts a revision plan, then rewrites the post after approval while retaining its original voice.

The workflow has six stages: audit, competitor research, gap analysis, planning, approval, and rewriting. Research requires web search or a SERP API, plus a tool that fetches competitor pages. Search Console, ranking data, and analytics can inform the audit when available.

The skill waits for approval before drafting the refreshed post. It also rules out promises of specific ranking or traffic gains.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill blog-refresher -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/blog-refresher/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/blog-refresher/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill blog-refresher -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/blog-refresher/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill blog-refresher -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/blog-refresher/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Illyism/seo-skills seo/blog-refresher/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/blog-refresher/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill blog-refresher -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Illyism/seo-skills --path seo/blog-refresher
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/blog-refresher/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill blog-refresher -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Illyism/seo-skills/tree/HEAD/seo/blog-refresher/SKILL.md

## When to use it
- compare a blog post’s coverage with competing search results
- spot outdated facts and broken links
- rework a post’s headings and section order
- prepare a revision plan before rewriting

## Example prompts
- Refresh this post about CRM selection and compare it with competing search results.
- Find out why this article trails the pages above it in search.
- Draft a revision plan for this post and wait for approval before rewriting it.

## Similar
- [blog-audit](https://affpapa.org/en/nevibecode/skills/blog-audit.md) — skill · 2700 installs
- [blog-geo](https://affpapa.org/en/nevibecode/skills/blog-geo.md) — skill · 2700 installs
- [blog-writing-guide](https://affpapa.org/en/nevibecode/skills/blog-writing-guide.md) — skill · 3500 installs
- [write-blog](https://affpapa.org/en/nevibecode/skills/write-blog.md) — skill · 485 installs
- [seo-content-marketing-claude-skills](https://affpapa.org/en/nevibecode/skills/seo-content-marketing-claude-skills.md) — skill · 1000 installs
- [r06-alirezarezvani-claude-code-tresor-seo](https://affpapa.org/en/nevibecode/skills/r06-alirezarezvani-claude-code-tresor-seo.md) — skill · 975 installs

From the same set: [illyism/seo-skills](https://affpapa.org/en/nevibecode/by/illyism/seo-skills.md) — 29 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
