Content Refresh skill
The refresh methodology Okara’s Writer Agent uses to diagnose decaying content and make the targeted updates that reclaim rankings — without discarding a URL’s earned equity.
Download the skill instructions, see an example refresh plan, or run it live inside the Writer Agent.
- Category
- Writer
- Agent
- Writer Agent
- Format
- content-refresh.md
- Price
- Free to download
The skill file
--- name: content-refresh description: Update existing content to reclaim rankings and relevance — diagnose decay, decide whether to update, consolidate, or prune, then make the specific changes that recover performance. owner: Okara Writer Agent --- # Content Refresh Fixing what you already have is often higher-ROI than writing something new. This skill finds decaying pages, diagnoses why, and makes the targeted changes that win back traffic — without throwing away the equity a URL has earned.
Log in to view, copy, and download the complete skill file.
About this skill
What is the Content Refresh?
The Content Refresh skill is the exact instruction set Okara’s Writer Agent follows when it updates existing content. It captures how the agent spots decay, diagnoses the cause, decides whether to update, consolidate, expand, or prune, and makes the specific changes that recover performance.
It’s written as a SKILL.md, a plain-language instruction format that both people and AI agents can follow directly. Read it to build a repeatable refresh process, hand it to your team, or let the Writer Agent audit and update your back catalog.
Downloading the instructions is free with an Okara account. Running the skill continuously — monitoring your library and refreshing pages as they decay — is part of the Writer Agent.
This is exactly the pattern SEO and content-ops teams call content decay: pages left untouched can lose a large share of their organic traffic as information ages and competitors publish fresher material, while pages that get proactively updated recover much of that lost ground within weeks of a real refresh. That’s the whole case for this skill — a page’s ranking history is an asset, and diagnosing why it decayed is what turns an update into a recovery instead of cosmetic churn.
Example
See it in action
You ask: “This guide used to be our top traffic driver and it’s been sliding for months. Can you fix it?”
Agent does: Diagnosis: intent shifted — the query now rewards a comparison, but your page is still a pure definition, and two competitors added sections you don’t have. Verdict: update in place, don’t rewrite. Specific changes: add a comparison table and two missing subtopics, refresh three stats from 2023, fix four dead links, and re-match the intro to the current intent. Keep the URL, update the publish date, and tighten the title. I’d expect recovery within a couple of index cycles — re-check rankings after two weeks.
Comparison
The skill vs. the alternatives
| Do it yourself | Hire a freelancer or agency | Content Refresh skill (free) | Writer Agent | |
|---|---|---|---|---|
| Cost | Your own time | $500–$5,000+ per project | Free with an Okara account | Included in the AI CMO plan |
| Time to first result | Hours to days, per attempt | Days to weeks, plus revision rounds | Minutes — download and follow it | Same day, runs automatically |
| Consistency over time | Depends on remembering to do it | Only as long as the retainer lasts | One-time; you re-run it yourself | Continuous, on a schedule |
| Who does the work | You, from scratch each time | Someone who has to learn your business first | You (or your agent), following the exact steps | Okara's Writer Agent, end to end |
How it works
From input to output
- 1
You point to a URL
Give the Writer Agent a page (or a set of pages) and any traffic or ranking data you have.
- 2
Okara diagnoses the decay
The agent names why the page slipped — stale data, lost intent match, stronger competitors, or missing subtopics.
- 3
It decides the move
Update, consolidate, expand, or prune and redirect — the right call for whether the page can recover.
- 4
You get a refresh plan
Specific, section-by-section changes plus on-page and internal-link updates that keep the URL’s earned equity.
What's included
Everything it covers
Decay detection
Finds pages with declining traffic or rankings and coverage that’s fallen behind.
Cause diagnosis
Names the reason — stale data, lost intent, stronger competitors, broken links — before any edit.
Update-or-prune verdict
Decides whether to update, consolidate, expand, or prune and redirect each page.
Specific change list
Section-by-section edits — data, examples, subtopics, and links — not vague "improve it" notes.
On-page re-optimization
Title, heading, and internal-link updates that re-match current intent.
Equity-preserving refresh
Keeps the existing URL so the page retains the authority it has already earned.
Use cases
When to reach for it
- Recover a page that used to rank and has been sliding.
- Update stale stats, dates, and screenshots that undercut trust.
- Re-match a page to search intent that has shifted.
- Consolidate overlapping posts into one stronger page.
- Compound a large back catalog instead of only writing new content.
Frequently Asked Questions
Related skills
Pair it with these skills
Blog Post
The blog-writing methodology Okara’s Writer Agent follows to turn a keyword into a focused, SEO-aware post that ranks and reads like a human wrote it.
--- name: blog-post description: Write a single, focused, SEO-aware blog post — one topic, one reader, one takeaway — that ranks in search and reads like a human wrote it. owner: Okara Writer Agent --- # Blog Post Write one publish-ready blog post built around a single topic and a single reader intent, structured to earn the search click and hold attention to the
Long-Form Content
The pillar-content methodology Okara’s Writer Agent uses to write comprehensive, authoritative guides that own a topic and earn links over time.
--- name: long-form-content description: Write a comprehensive, authoritative pillar guide (2,000-5,000+ words) that covers a topic end to end, anchors a content cluster, and earns links and rankings over time. owner: Okara Writer Agent --- # Long-Form Content Produce a definitive, in-depth guide that owns a broad topic — the page a reader bookmarks and other sites link to — not a quick post. Depth, structure,
Listicle
The list-article methodology Okara’s Writer Agent uses to write scannable, curated listicles where every item earns its place and the framing makes the choice easy.
--- name: listicle description: Write a scannable list article — "N X for Y" — with a curated set of items, parallel structure, and a framing that makes the reader's decision easier. owner: Okara Writer Agent --- # Listicle Write a list-format article that's genuinely useful, not padded. Every item earns its place, the structure is consistent, and the intro and wrap-up turn a
How-To Guide
The instructional-writing methodology Okara’s Writer Agent uses to turn a task into a step-by-step guide a reader can actually follow to the finish.
--- name: how-to-guide description: Write step-by-step instructional content that takes a reader from a clear starting point to a specific outcome, with prerequisites, testable steps, and troubleshooting. owner: Okara Writer Agent --- # How-To Guide Write a guide that gets the reader to a result. The measure of success is simple: can someone follow it and finish the task? Structure, sequence, and
Content Brief
The briefing methodology Okara’s Writer Agent uses to specify a piece — goal, audience, angle, structure, and specs — so it gets written right the first time.
--- name: content-brief description: Produce a writer-ready content brief that specifies the goal, audience, angle, structure, and specs so a piece can be written correctly the first time. owner: Okara Writer Agent --- # Content Brief Write the brief, not the article. A great brief removes ambiguity so any writer — human or AI — can execute it without a round of follow-up questions
Content Outline
The outlining methodology Okara’s Writer Agent uses to build a complete, logically sequenced heading hierarchy before a single sentence gets drafted.
--- name: content-outline description: Build the structural skeleton of a piece before drafting — a heading hierarchy with bulleted talking points that covers the query completely and flows logically. owner: Okara Writer Agent --- # Content Outline Design the skeleton before anyone writes a sentence. A strong outline decides what the piece covers and in what order, so drafting becomes filling in points