Skip to content
Skills Library
Marketing & content · Analysis

content-refresh

/content-refresh

Use when the user wants to update old content, recover lost rankings or traffic for specific pages, fix content decay, or asks why a page that used to rank has dropped and how to improve it. Finds decaying pages with Search Console data, diagnoses the cause and gives a concrete refresh plan.

Repository
seo-skills ↗
Licence
MIT
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when the user wants to update old content, recover lost rankings or traffic for specific pages, fix content decay, or asks why a page that used to rank has dropped and how to improve it. Finds decaying pages with Search Console data, diagnoses the cause and gives a concrete refresh plan.

Original author description

Use when the user wants to update old content, recover lost rankings or traffic for specific pages, fix content decay, or asks why a page that used to rank has dropped and how to improve it. Finds decaying pages with Search Console data, diagnoses the cause and gives a concrete refresh plan.

How it works

  1. Before you start
  2. Find candidates
  3. Diagnose the cause (check in this order)
  4. Refresh actions
  5. Output format
  6. Follow-up
  7. Related skills
Original SKILL.md headings · 58 lines, 377 words
SKILL.md preview
---
name: content-refresh
description: Use when the user wants to update old content, recover lost rankings or traffic for specific pages, fix content decay, or asks why a page that used to rank has dropped and how to improve it. Finds decaying pages with Search Console data, diagnoses the cause and gives a concrete refresh plan.
---

# Content Refresh

You bring declining pages back. Updating a page that already has history and links is often faster than publishing a new one.

## Before you start

1. Read `.agents/seo-context.md`.
2. Best input: GSC Pages + Queries export comparing two periods (last 3 months vs previous 3 months, and year over year to rule out seasonality).
3. Without GSC, ask for the specific URLs and the keywords they used to rank for.

## Find candidates

- Pages with a clear drop in clicks or impressions (exclude seasonal dips by checking year over year)
- Pages stuck in positions 5-20 for valuable queries
- Pages with outdated info: old prices, old years in the title, discontinued products, old regulations
- Pages with high impressions and low CTR (title / snippet problem)

## Diagnose the cause (check in this order)

1. **Technical**: noindex, canonical changes, redirects, a site migration, indexing status in GSC URL Inspection
2. **Cannibalization**: a newer page now competes for the same queries
3. **SERP change**: intent shifted (e.g. now videos, AI Overview, local pack, directories)
4. **Competitors improved**: fresher, deeper, better proof
5. **Content is outdated** or thin compared with what ranks now
6. **Lost links** or internal links removed
7. **Algorithm update**: check the dates against known Google updates before blaming one

## Refresh actions

- Re-check intent against the current top results and restructure if needed
- Update facts, prices, years, screenshots and photos
- Add missing subtopics and questions (PAA, GSC queries the page already gets impressions for)
- Add first-hand proof: real projects, numbers, quotes
- Improve the title and meta for CTR
- Remove or merge sections that no longer help
- Add internal links from strong related pages
- Keep the same URL
- Change the "updated" date only when the change is substantive
- Request indexing in GSC after publishing

## Output format

```markdown
| URL | Drop (period vs period) | Likely cause (evidence) | Refresh actions | Priority |
|---|---|---|---|---|
```

Then for each priority page: the new outline, the title and meta options, and what to add or remove.

## Follow-up

Check results 4-8 weeks after the refresh in GSC (same query set, same comparison method).

## Related skills

`search-console-analysis`, `keyword-cannibalization`, `seo-content-writing`, `on-page-seo`

Versions

RepositoryScoreLicence
This page · AmmarBabbar/seo-skills100MIT
calm-seo/seo-skills100MIT
harlan-zw/harlan-claude-code95MIT

Database snapshot: 13.11.2026 · package version 55e732d06d3f (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100clickd-content-refresh
    Finds decaying or outdated pages on a website using Search Console traffic trends and clickd page checks, diagnoses whether clicks dropped from position loss, CTR decay or stale facts, updates the page in code, and verifies the refreshed page live with clickd. Use when asked to…
  • 90content-decay
    Find, triage and build a recovery plan for decaying content in Google Search Console data through the Organiq MCP server (find_decaying_content, get_timeseries, query_top_queries, get_annotations). Use when the user asks about pages losing traffic, declining clicks, content…
  • 100content-decay
    Use when the user wants to find which pages are losing search traffic and which to refresh first - content decay, content refresh, "our blog traffic is flat", declining organic clicks, or a content audit from Search Console. Also use when the user mentions content decay, content…
  • 100content-decay
    Find pages that lost clicks between two periods, work out the likely reason (lost rankings, less demand, lower CTR, page gone from the report), cross-check the drop dates against the Google Search Status Dashboard, and refresh only what needs it. Uses the decay command on two…
  • 90content-decay-analysis
    Finds pages that are quietly losing organic traffic over time, from live Google Search Console data in your Coupler.io workspace — which pages are down on clicks, whether it's a ranking slip or fewer people searching, and which are worth updating first. Use for "which of my…
  • 100content-decay-refresh
    Finds pages losing Google clicks in Search Console, works out why (lost rank, lower CTR, cannibalisation, redirect or demand), checks update timing and AI Overview impact, and ranks a refresh list. Use when asked which pages to refresh, why organic clicks dropped or if AI Overviews took clicks.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.