Analyzes outdated content URLs for refresh opportunities, suggests updates with stats, sections, and freshness signals to recover rankings and traffic. Triggers on decline mentions.
From seo-geo-claude-skillsnpx claudepluginhub aaron-he-zhu/seo-geo-claude-skillsThis skill uses the workspace's default tool permissions.
references/content-decay-signals.mdreferences/refresh-example.mdreferences/refresh-templates.mdDesigns and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
SEO & GEO Skills Library · 20 skills for SEO + GEO · ClawHub · skills.sh System Mode: This optimization skill follows the shared Skill Contract and State Model.
This skill helps identify and revitalize outdated content to reclaim lost rankings and traffic. It analyzes content freshness, identifies update opportunities, and guides the refresh process for maximum SEO and GEO impact.
System role: Optimization layer skill. It turns weak pages, structures, and technical issues into prioritized repair work.
Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:
Use this whenever the task needs a diagnosis or repair plan that should feed directly into remediation work, not just a one-time opinion.
Start with one of these prompts. Finish with a short handoff summary using the repository format in Skill Contract.
Find content on [domain] that needs refreshing
Which of my blog posts have lost the most traffic?
Refresh this article for [current year]: [URL/content]
Update this content to outrank [competitor URL]: [your URL]
Create a content refresh strategy for [domain/topic]
Expected output: a scored diagnosis, prioritized repair plan, and a short handoff summary ready for memory/audits/.
memory/audits/.memory/open-loops.md and memory/decisions.md.Next Best Skill below when the repair path is clear.See CONNECTORS.md for tool category placeholders.
With ~~analytics + ~~search console + ~~SEO tool connected: Claude can automatically pull historical traffic trends from ~~analytics, fetch impression and ranking data from ~~search console, retrieve keyword position history from ~~SEO tool, and identify content with declining performance. This enables data-driven refresh prioritization.
With manual data only: Ask the user to provide:
Proceed with the analysis using provided data. Note in the output which findings are from automated data vs. manual review.
When a user requests content refresh help:
CORE-EEAT Quick Score — Identify Weak Dimensions
Before refreshing, run a quick CORE-EEAT assessment to focus effort on the weakest areas. Reference: CORE-EEAT Benchmark
### CORE-EEAT Quick Assessment
**Content**: [title or URL]
**Content Type**: [type]
Rapidly score each dimension (estimate 0-100):
| Dimension | Quick Score | Key Weakness | Refresh Priority |
|-----------|-----------|--------------|-----------------|
| C — Contextual Clarity | [X]/100 | [main issue] | 🔴/🟡/🟢 |
| O — Organization | [X]/100 | [main issue] | 🔴/🟡/🟢 |
| R — Referenceability | [X]/100 | [main issue] | 🔴/🟡/🟢 |
| E — Exclusivity | [X]/100 | [main issue] | 🔴/🟡/🟢 |
| Exp — Experience | [X]/100 | [main issue] | 🔴/🟡/🟢 |
| Ept — Expertise | [X]/100 | [main issue] | 🔴/🟡/🟢 |
| A — Authority | [X]/100 | [main issue] | 🔴/🟡/🟢 |
| T — Trust | [X]/100 | [main issue] | 🔴/🟡/🟢 |
**Weakest Dimensions** (focus refresh here):
1. [Dimension] — [what needs fixing]
2. [Dimension] — [what needs fixing]
**Refresh Strategy**: Focus on 🔴 dimensions first, then 🟡.
_For full 80-item audit, use [content-quality-auditor](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/content-quality-auditor/SKILL.md)_
Identify Content Refresh Candidates
## Content Refresh Analysis
### Refresh Candidate Identification
**Criteria for Content Refresh**:
- Published more than 6 months ago
- Contains dated information (years, statistics)
- Declining traffic trend
- Lost keyword rankings
- Outdated references or broken links
- Missing topics competitors now cover
- No GEO optimization
### Content Audit Results
| Content | Published | Last Updated | Traffic Trend | Priority |
|---------|-----------|--------------|---------------|----------|
| [Title 1] | [date] | [date] | ↓ -45% | 🔴 High |
| [Title 2] | [date] | Never | ↓ -30% | 🔴 High |
| [Title 3] | [date] | [date] | ↓ -20% | 🟡 Medium |
| [Title 4] | [date] | [date] | → 0% | 🟡 Medium |
### Refresh Prioritization Matrix
High Traffic + High Decline = 🔴 Refresh Immediately High Traffic + Low Decline = 🟡 Schedule Refresh Low Traffic + High Decline = 🟡 Evaluate & Decide Low Traffic + Low Decline = 🟢 Low Priority
Analyze Individual Content for Refresh
## Content Refresh Analysis: [Title]
**URL**: [URL]
**Published**: [date]
**Last Updated**: [date]
**Word Count**: [X]
### Performance Metrics
| Metric | 6 Mo Ago | Current | Change |
|--------|----------|---------|--------|
| Organic Traffic | [X]/mo | [X]/mo | [+/-X]% |
| Avg Position | [X] | [X] | [+/-X] |
| Impressions | [X] | [X] | [+/-X]% |
| CTR | [X]% | [X]% | [+/-X]% |
### Keywords Analysis
| Keyword | Old Position | Current Position | Change |
|---------|--------------|------------------|--------|
| [kw 1] | [X] | [X] | ↓ [X] |
| [kw 2] | [X] | [X] | ↓ [X] |
| [kw 3] | [X] | [X] | ↓ [X] |
### Why This Content Needs Refresh
1. **Outdated information**: [specific examples]
2. **Competitive gap**: [what competitors added]
3. **Missing topics**: [new subtopics to cover]
4. **SEO issues**: [current optimization problems]
5. **GEO potential**: [AI citation opportunities]
Identify Specific Updates Needed
## Refresh Requirements
### Outdated Elements
| Element | Current | Update Needed |
|---------|---------|---------------|
| Year references | "[old year]" | Update to [current year] |
| Statistics | "[old stat]" | Find current data |
| Tool mentions | "[old tool]" | Add newer tools |
| Links | [X] broken | Fix or replace |
| Screenshots | Outdated UI | Recapture |
### Missing Information
**Topics competitors now cover that you don't**:
| Topic | Competitor Coverage | Words Needed | Priority |
|-------|---------------------|--------------|----------|
| [Topic 1] | 3/5 competitors | ~300 words | High |
| [Topic 2] | 2/5 competitors | ~200 words | Medium |
| [Topic 3] | 4/5 competitors | ~400 words | High |
### SEO Updates Needed
- [ ] Update title tag with current year
- [ ] Refresh meta description
- [ ] Add new H2 sections for [topics]
- [ ] Update internal links to newer content
- [ ] Add FAQ section for featured snippets
- [ ] Refresh images and add new alt text
### GEO Updates Needed
- [ ] Add clear definition at start
- [ ] Include quotable statistics with sources
- [ ] Add Q&A formatted sections
- [ ] Update sources with current citations
- [ ] Create standalone factual statements
Create Refresh Plan — Structural changes, content additions, statistics/links/images to update
Reference: See references/refresh-templates.md for the full refresh plan template (Step 5).
Write Refresh Content — Updated introduction, new sections, refreshed statistics, new FAQ section
Reference: See references/refresh-templates.md for the refresh content writing template (Step 6).
Optimize for GEO During Refresh — Clear definitions, quotable statements, Q&A sections, updated citations
Reference: See references/refresh-templates.md for the GEO enhancement template (Step 7).
Generate Republishing Strategy — Date strategy (update/add "last updated"/keep original), technical implementation, promotion plan
Reference: See references/refresh-templates.md for the republishing strategy template (Step 8).
Create Refresh Report — Summary of changes, updates completed, expected outcomes, next review date
Reference: See references/refresh-templates.md for the refresh report template (Step 9).
Reference: See references/refresh-example.md for a full worked example (cloud hosting refresh) and the comprehensive content refresh checklist.
Reference data: For content decay signal taxonomy, lifecycle stages, refresh vs. rewrite decision framework, and update strategy by content type, see references/content-decay-signals.md.
After delivering audit or optimization findings to the user, ask:
"Save these results for future sessions?"
If yes, write a dated summary to memory/audits/content-refresher/YYYY-MM-DD-<topic>.md containing:
If any veto-level issue was found (CORE-EEAT T04, C01, R10 or CITE T03, T05, T09), also append a one-liner to memory/hot-cache.md without asking.
Gate check recommended: Run content-quality-auditor on refreshed content before republishing.