Content Refresh Brief
Overview
Given a URL and optionally its GSC/GA4 performance data, produce a structured refresh brief that covers SERP intent analysis, entity gaps, content outline, internal link plan, and technical recommendations.
Inputs
- URL of the page to refresh
- Current GSC performance (clicks, impressions, CTR, avg position, top queries)
- Prior period GSC performance for comparison
- Optional: page content (if the user pastes it)
- Optional: GA4 engagement or conversion data
Workflow
- Search the page's primary query in a current SERP.
- Analyze top 5 organic results for:
- Content format (guide, list, tool, video, etc.)
- Content depth (word count, section count, entities covered)
- Date freshness (when each page was last updated)
- SERP features present (featured snippets, People Also Ask, video, etc.)
- Compare current page content against SERP expectations:
- Does it match the dominant content format?
- Are key entities missing?
- Is the content depth competitive?
- Is the page fresh enough?
- Review GSC query data to identify:
- Queries with declining CTR despite stable impressions
- Queries where the page ranks but doesn't satisfy intent
- Queries from the prior period that stopped driving traffic
- Recommend:
- Content changes (restructure, expand, add sections, update data)
- Technical changes (title, meta description, schema, canonical)
- Internal link additions (from high-traffic pages)
- Entities to add or strengthen
- Estimate effort and expected recovery.
Output Format
## Refresh Brief: /page-url
### Current Performance
| Metric | Current | Prior | Change |
|---|---|---|---|
### SERP Intent Analysis
[Format, depth, freshness expectations from top results]
### Gap Analysis
| Gap | Competitor Example | Our Action |
|---|---|---|
### Recommended Content Changes
1. [Action with details]
### Recommended Technical Changes
1. [Action with details]
### Internal Link Plan
| Source Page | Anchor Text | Rationale |
|---|---|---|
### Effort Estimate
[Low / Medium / High] — [estimated hours]
### Expected Recovery
[Estimated click/impression recovery range]
Related Skills
traffic-decay-detector — identifies which pages need briefs.serp-authority-mark — checks authority feasibility for the target query.title-meta-rewriter — produces title/meta alternatives for the refresh.
1---2name: content-refresh-brief3description: Produce a focused refresh brief for a declining page. Use when Codex needs to research SERP intent, competitor content, entity coverage, and internal link opportunities to create an actionable page refresh plan.4---56# Content Refresh Brief78## Overview910Given a URL and optionally its GSC/GA4 performance data, produce a structured refresh brief that covers SERP intent analysis, entity gaps, content outline, internal link plan, and technical recommendations.1112## Inputs1314- URL of the page to refresh15- Current GSC performance (clicks, impressions, CTR, avg position, top queries)16- Prior period GSC performance for comparison17- Optional: page content (if the user pastes it)18- Optional: GA4 engagement or conversion data1920## Workflow21221. Search the page's primary query in a current SERP.232. Analyze top 5 organic results for:24 - Content format (guide, list, tool, video, etc.)25 - Content depth (word count, section count, entities covered)26 - Date freshness (when each page was last updated)27 - SERP features present (featured snippets, People Also Ask, video, etc.)283. Compare current page content against SERP expectations:29 - Does it match the dominant content format?30 - Are key entities missing?31 - Is the content depth competitive?32 - Is the page fresh enough?334. Review GSC query data to identify:34 - Queries with declining CTR despite stable impressions35 - Queries where the page ranks but doesn't satisfy intent36 - Queries from the prior period that stopped driving traffic375. Recommend:38 - Content changes (restructure, expand, add sections, update data)39 - Technical changes (title, meta description, schema, canonical)40 - Internal link additions (from high-traffic pages)41 - Entities to add or strengthen426. Estimate effort and expected recovery.4344## Output Format4546```markdown47## Refresh Brief: /page-url4849### Current Performance50| Metric | Current | Prior | Change |51|---|---|---|---|5253### SERP Intent Analysis54[Format, depth, freshness expectations from top results]5556### Gap Analysis57| Gap | Competitor Example | Our Action |58|---|---|---|5960### Recommended Content Changes611. [Action with details]6263### Recommended Technical Changes641. [Action with details]6566### Internal Link Plan67| Source Page | Anchor Text | Rationale |68|---|---|---|6970### Effort Estimate71[Low / Medium / High] — [estimated hours]7273### Expected Recovery74[Estimated click/impression recovery range]75```7677## Related Skills7879- `traffic-decay-detector` — identifies which pages need briefs.80- `serp-authority-mark` — checks authority feasibility for the target query.81- `title-meta-rewriter` — produces title/meta alternatives for the refresh.
marketingskills