blog-refresher SKILL.md skillA

blog-refresher from illyism/seo-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add illyism/seo-skills/blog-refresher@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
illyism/seo-skills
Path
seo/blog-refresher/SKILL.md
Versions recorded
1
Latest version
v1.0.0, committed Oct 6, 2026
Size
6,199 bytes
Repository stars
548
License
none declared

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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

1. **Current state analysis**: assess the existing post
2. **Competitor research**: analyze the top 5–10 SERP results
3. **Gap identification**: what competitors have that the post lacks
4. **Improvement plan**: a structured upgrade strategy
5. **Approval checkpoint**: present findings and wait for approval
6. **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
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add illyism/seo-skills/blog-refresher@sha256:a251bd87509ab50a

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_lmh3curuzflymqu3.svg)](https://markdownregistry.com/a/art_lmh3curuzflymqu3)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 6, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-10-06 9f82878 6,199 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6199 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

illyism/seo-skills · 548 stars · license none declared · pushed 2026-10-15 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lmh3curuzflymqu3
GET https://markdownregistry.com/api/v1/resolve?ref=illyism/seo-skills/blog-refresher
GET https://markdownregistry.com/api/v1/blob/a251bd87509ab50ab83d36f281048e2c0556d6a31103bc5be2a358b207a9ab3b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from illyism/seo-skills

intro SKILL.md skill
illyism/seo-skills · content/intro/SKILL.md · Write short, Semrush-style blog post intros with journey teasers, practical relevance, and reader intent matching. Use…
v1.0.0 · audit A · 548 stars
scribiz SKILL.md skill
illyism/seo-skills · content/scribiz/SKILL.md · Get the transcript, on-screen text, summary, and chapters of any video or audio with Scribiz. Use when the user wants…
v1.0.0 · audit A · 548 stars
blitz-copy SKILL.md skill
illyism/seo-skills · copywriting/blitz-copy/SKILL.md · When the user wants high-converting copy for landing pages, headlines, cold emails, X/LinkedIn posts, video intros, or…
v1.0.0 · audit F · 548 stars
understand-customers SKILL.md skill
illyism/seo-skills · copywriting/understand-customers/SKILL.md · When the user wants to deeply understand their ideal customer before writing copy — pains, desires, inner monologue…
v1.0.0 · audit A · 548 stars
customer-journey SKILL.md skill
illyism/seo-skills · marketing/customer-journey/SKILL.md · Map how customers discover, evaluate, and choose a product across Google, AI chatbots (ChatGPT, Claude, Perplexity)…
v1.0.0 · audit A · 548 stars
diff-marketing SKILL.md skill
illyism/seo-skills · marketing/diff-marketing/SKILL.md · Generate customer-focused marketing content from recent git changes, commits, merged pull requests, and shipped…
v1.0.0 · audit A · 548 stars
blitz-seo SKILL.md skill
illyism/seo-skills · seo/blitz-seo/SKILL.md · When the user wants to rank one high-value page fast, run a focused SEO sprint, or is stuck on page 2 for a money…
v1.0.0 · audit A · 548 stars
linkdr SKILL.md skill
illyism/seo-skills · seo/linkdr/SKILL.md · LinkDR is a managed backlink service. Use when the user wants authority backlinks, link building, guest posts, or…
v1.8.0 · audit A · 548 stars
seo-autopilot SKILL.md skill
illyism/seo-skills · seo/seo-autopilot/SKILL.md · When the user wants an agent to run SEO for a product end to end on a daily schedule, with state kept in a seo/ folder…
v1.0.0 · audit A · 548 stars
seo-title-optimization SKILL.md skill
illyism/seo-skills · seo/seo-title-optimization/SKILL.md · Rewrite and audit SEO page titles, title tags, MDX frontmatter titles, H1 alignment, and bulk title improvements. Use…
v1.0.0 · audit A · 548 stars

Every file in illyism/seo-skills

Browse by kind, by grade A, or by owner.