illyism/seo-skills/blog-refresher
Claude Code and agent skill by illyism/seo-skills
- community
Checking that the SKILL.md file is still in the repository.
Refresh and improve existing blog posts to outrank competitors using a 6-phase content audit and SERP gap analysis. Use when the user wants to update, refresh, or improve an existing blog post, recover lost rankings, or asks why a post fell behind competitors.
Install
npx vskill@latest install illyism/seo-skills/blog-refresherSKILL.md
Blog Refresher
You update existing blog posts so they outrank the pages above them. Analyze the post, compare it with the top-ranking competitors, find the gaps, and write an improved version that keeps the original voice.
Use real research tools: web search or a SERP API for rankings, and a page fetcher for competitor content. Do not rely on memory for what ranks or what competitors say. Use today's date for anything time-sensitive.
Keep messages short and actionable until the final refreshed content.
The 6-phase framework
- Current state analysis: assess the existing post
- Competitor research: analyze the top 5–10 SERP results
- Gap identification: what competitors have that the post lacks
- Improvement plan: a structured upgrade strategy
- Approval checkpoint: present findings and wait for approval
- Content recreation: write the refreshed version
Phase 1: Current state analysis
Content audit checklist
Initial assessment
Phase 2: Competitor research
Step 1: Read the SERP
Extract the top 10 titles, the featured snippet, People Also Ask questions, related searches, and the dominant content format.
Step 2: Pick 5 competitors
Prioritize direct competitors, pages ranking #1–3, recently updated content, and pages with visible engagement.
Step 3: Audit each competitor page
Phase 3: Gap analysis
Build a table that compares the post with each competitor:
| Element | Your post | Comp 1 | Comp 2 | Comp 3 | Comp 4 | Comp 5 | Priority | |
|---|---|---|---|---|---|---|---|---|
| Word count | ||||||||
| Featured snippet format | ||||||||
| [Topic 1] | ||||||||
| [Topic 2] | ||||||||
| Statistics / data | ||||||||
| Examples / cases | ||||||||
| Visuals | ||||||||
| FAQ section | ||||||||
| Schema markup |
Then list missing topics by priority:
- High: covered by 4+ competitors
- Medium: covered by 2–3 competitors
- Low: covered by 1 competitor
- Emerging: angles nobody covers yet
Finish with each competitor's unique angle and the post's opportunity to differentiate.
Phase 4: Refresh strategy
Proposed outline
- 3 new title options (current year or new angle, snippet-focused, differentiated)
- The new H2 structure, each marked Keep / Modified / New with what changes
- Target word count and new elements (table, FAQ, diagram)
Phase 5: Approval
Present the plan before writing:
Do not promise specific ranking or traffic gains.
Phase 6: Writing the refresh
Keep what works
- Sections that already rank well
- The original voice and tone
- The URL (or plan a 301 redirect)
- Existing anchors that other pages link to
Improve
- Add a visible "Last updated: [date]"
- Cite the year next to every statistic
- Go deeper than competitors on the topics that matter
- Add original data, examples, or diagrams competitors lack
Make it scannable
- Paragraphs of 2–3 sentences
- More H3s
- Lists and tables where they help
- Jump links for long posts
SEO checklist
Output format
Quality check
- Every gap from Phase 3 is addressed or consciously skipped
- All data and examples are current and sourced
- The original voice is intact
- No keyword stuffing
- The post gives more practical value than each competitor analyzed
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingseo/blog-refresher/SKILL.md
Popularity
- Repository stars
- 530
- Repository forks
- 56
- 7-day trend score
- 0
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/illyism/seo-skills/blog-refresher)