blog-refresher — Claude Code skill for refreshing posts
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.
no license 842 installs ★ 1,797 updated 2026-11-16
npx skills add Illyism/seo-skills --skill blog-refresher -a claude-codeWhat blog-refresher 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.
What it helps with
- 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 for the agent
- 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.
How to install blog-refresher
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill blog-refresher -a claude-code2Manually: put the files in place
~/.claude/skills/blog-refresher/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/blog-refresher/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill blog-refresher -a codex2Manually: put the files in place
.agents/skills/blog-refresher/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill blog-refresher -a cursor2Manually: put the files in place
.cursor/skills/blog-refresher/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Illyism/seo-skills seo/blog-refresher/SKILL.md2Manually: put the files in place
.github/skills/blog-refresher/SKILL.md1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill blog-refresher -a gemini-cli2Platform CLI
gemini skills install https://github.com/Illyism/seo-skills --path seo/blog-refresherManually: put the files in place
.devin/skills/blog-refresher/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill blog-refresher -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 blog-refresher
How do I install blog-refresher in Claude Code?
Run npx skills add Illyism/seo-skills --skill blog-refresher -a claude-code. The skill file is at ~/.claude/skills/blog-refresher/SKILL.md.
What does blog-refresher do?
It audits an existing post, compares it with competing search pages, and proposes revisions. Once the plan is approved, it rewrites the post while keeping its original voice.
What does blog-refresher need to work?
Research needs web search or a SERP API and a page-fetching tool for competitor pages. Search Console, ranking data, and analytics can be used when available.