blog-refresher
Refresh and improve existing blog posts to outrank competitors using a 6-phase content audit and SERP gap analysis
Install / Use
npx skills add Illyism/seo-skills --skill blog-refresherInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of blog-refresher
blog-refresher scores 87/100 on our quality scale, 697th of 1,171 Content & Media skills we index.
Its SKILL.md is 6.0 KB long, well organised into 26 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
It has 531 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated 13 days ago, so blog-refresher is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
blog-refresher compared with similar skills
All 4 of these similar skills score higher than blog-refresher; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| blog-refresher (this skill)by Illyism | 87 | 531 | 13d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.0k | today | MCP Server |
| algorithmic-artby anthropics | 100 | 177.9k | 36d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 36d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 137.2k | 13d ago | SKILL.md |
Frequently asked questions
- How do I install blog-refresher?
- Run
npx skills add Illyism/seo-skills --skill blog-refresher. The install tabs above show the steps for each supported agent. - Which AI agents does blog-refresher work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is blog-refresher safe to use?
- It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is blog-refresher still maintained?
- The repository was last updated 13 days ago, so blog-refresher is actively maintained.
Skill content
View source on GitHubname: blog-refresher description: 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. metadata: version: 1.0.0 author: illyism source: https://il.ly/skills/blog-refresher
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
BASIC METRICS
□ Word count
□ Last updated
□ Current ranking for the main keyword (if Search Console or rank data exists)
□ Page traffic per month (if analytics exists)
STRUCTURE
□ Number of H2s and H3s
□ Lists, tables, images, media
□ Internal and external links
QUALITY
□ Readability (grade level)
□ Content depth: shallow / medium / deep
□ Unique insights
□ CTAs present
Initial assessment
EXISTING POST ANALYSIS
Title:
URL:
Primary keyword:
STRENGTHS: what works, unique angles, strong sections to keep
WEAKNESSES: outdated information, missing topics, weak sections, poor flow
QUICK WINS: easy updates, stats to refresh, broken links to fix
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
URL / Ranking position
Word count
H2 sections and H3 breakdown
Unique elements: features, data, examples, visuals, interactive tools
Last modified date
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
IMMEDIATE
□ Update outdated statistics to the latest available data
□ Fix broken links
□ Add missing high-priority topics
□ Format the answer for the featured snippet
□ Refresh examples and screenshots
STRUCTURE
□ Reorder H2s for better flow
□ Add an FAQ from People Also Ask
□ Add comparison tables
□ Improve the intro hook
OPTIMIZATION
□ Target word count
□ Internal links to add
□ Authoritative external sources to cite
□ Image alt text
□ Schema markup
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:
## Content refresh plan: [Post title]
### Summary
The post ranks #[X] and has fallen behind on [areas]. This refresh adds [N] sections and updates [N] outdated elements.
### Key findings
1. Content depth: competitors average [X] words vs [Y]
2. Missing topics: [top 3 gaps]
3. Outdated elements: [main issues]
4. Opportunity: [unique angle]
### Gap table
### New outline
Shall I write the refreshed version? Any sections to prioritize?
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
□ Title tag 50–60 characters
□ Meta description 150–160 characters
□ Primary keyword in the first 100 words
□ Related terms used naturally
□ Snippet-ready answer near the top
□ FAQ answers People Also Ask
□ Internal links to and from related posts
Output format
# [New title]
_Last updated: [date]_
[New intro]
[Jump links]
[Refreshed sections]
## Frequently asked questions
## Conclusion
---
### Refresh summary for the publisher
- Meta description: [new]
- Schema: [types to add]
- Internal links: [pages to link]
- Images needed: [list]
- URL: [keep / redirect plan]
- Word count: [old] → [new]
- Sections added: [list]
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
Related Skills
siyuan
47.0kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
137.2kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
