Individual skill

content-refresh-auditor

Produces a prioritized refresh plan for a decaying published page - a refresh/consolidate/retire verdict plus ordered update actions to recover or grow rankings. Use when an existing URL is losing traffic or rankings, during a periodic content-decay sweep, or when asked to "update", "refresh", or "revive" an old article. Do NOT use when planning coverage for a draft that is not yet published or ranking - use SERP Gap Analyzer instead.

skills/content-refresh-auditor/SKILL.md

Read pinned source

Source commit 97a13607d669157a4a16d5ba79b77f208319f7b9

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
No
Repository scan complete
No
Skill scan complete
Yes
Observed behavior
Not checked yet
Last checked
Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
24
Repository last updated
Oct 13, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt
# Content Refresh Auditor

Most ranking decay is the SERP moving on while a page stood still: intent shifted, competitors expanded, facts aged. Refreshing a page that already holds authority and links is usually higher ROI than writing a new one. Produce a concrete diff between what the page says and what the query now demands, then a prioritized action list.

## Workflow

1. **Gather evidence first.** Pull the page's current position, traffic trend, and backlinks, and load the live top 10 for its target query. A sustained decline of 20-30% year over year is the usual trigger for a page entering the audit; a week-over-week wobble is not. Do not recommend any action before you have read today's SERP and the page's current standing - refresh decisions are evidence-gated, not from memory.
2. **Decide refresh, consolidate, or retire.** Refresh pages with residual rankings (positions ~5-20), backlinks, or leftover traffic - they have equity to recover. Consolidate when two pages compete for one intent. Retire and 301-redirect thin pages with no referring domains and negligible traffic (under ~10 organic visits a month with no path to relevance is a defensible retire line). State the verdict explicitly before listing actions; never refresh a page that should be merged.
3. **Re-check intent against today's SERP.** Compare the page's format to what now ranks. If the SERP shifted from guides to comparisons, or now shows shopping or video packs, the page type may be obsolete. Realigning page type to current intent is often the single biggest lever.
4. **Diff against the page's lost coverage.** List subtopics, entities, tools, and People Also Ask questions the current top results cover that this page once won or now omits. Frame this as the delta the page has fallen behind on - not a from-scratch coverage map for a new draft (that is SERP Gap Analyzer's job).
5. **Update freshness signals honestly.** Replace outdated stats, years, screenshots, prices, and dead examples. Rewrite the title and meta if they reference an old framing. Fix broken links and prune outbound links to dead pages. Bump the modified date only when content genuinely changed - fake date bumps are detected and ignored.
6. **Rebuild internal links and answer blocks.** Add links from newer related pages into the refreshed article and update its own links to current targets. Restructure the lead and key sections into concise answer blocks to recapture featured snippets and AI citations that drifted to competitors.
7. **Prioritize by recovery potential.** Order every action by expected traffic recovery against effort. Lead with intent realignment and coverage gaps on the highest-equity pages. Set expectations on timing: movement typically registers 4-12 weeks after the recrawl, so schedule the re-measurement then, and run the decay sweep itself on a quarterly cadence rather than waiting for a traffic crisis.

## Deliverable
Back to top