seo-content-audit

$npx mdskill add rampstackco/claude-skills/seo-content-audit

Audit content to decide keep, update, merge, redirect, or delete.

  • Diagnoses site-wide traffic decline or content decay.
  • Uses content inventory and performance data from analytics.
  • Scores each page by traffic, relevance, and cannibalization.
  • Outputs a prioritized action list for each URL.

SKILL.md

.github/skills/seo-content-auditView on GitHub ↗
---
name: seo-content-audit
description: "Audit existing content across a site to decide what to keep, update, merge, redirect, or delete. Use this skill whenever the user wants to audit existing content, fix content decay, resolve keyword cannibalization, prune underperforming pages, prioritize content updates, or apply a keep/update/merge/redirect/delete framework to a content library. Triggers on content audit, content decay, content refresh, cannibalization, keyword cannibalization, prune content, delete pages, redirect old pages, content inventory, what to keep, what to update, content scorecard, evergreen refresh. Also triggers when traffic is dropping site-wide and the cause might be content quality, even if 'audit' is not said explicitly."
category: seo-foundation
catalog_summary: "Keep/update/merge/redirect/delete decisions across a site"
display_order: 6
---

# Content Audit

Inventory existing content, score it, and decide for each piece: keep, update, merge, redirect, or delete. Stack-agnostic. Works on blogs, marketing sites, knowledge bases, and product content.

---

## When to use

- Inheriting a content library you did not create
- Diagnosing site-wide traffic decline
- Resolving cannibalization (two pages competing for the same query)
- Pre-migration cleanup
- Annual or semi-annual content health check
- Pruning before a redesign or replatform

## When NOT to use

- Optimizing a single page (use `seo-onpage`)
- Planning new content (use `seo-keyword`)
- Comparing your content to competitors (use `seo-competitor`)
- Site-level technical issues (use `seo-technical`)

---

## Required inputs

- The site URL and access to crawl it (or a complete URL list)
- Search console access (or a 12-month export)
- Analytics access (sessions, conversions, engagement)
- A backlink tool (to identify pages with referring domains worth preserving)

---

## The framework: 5 actions

For every content piece, the audit produces one of five decisions.

### 1. Keep
The page performs well, has clear intent, and needs no changes.

**Signals:**
- Top 10 ranking for its primary query
- Consistent traffic with no decay
- Healthy engagement (above-site-average time on page or interaction rate)
- Up-to-date information

### 2. Update
The page has potential but is underperforming due to fixable issues.

**Signals:**
- Page 2 ranking for high-value queries (rank 11 to 30)
- Traffic decay over the last 6 to 12 months
- Information gone stale
- Title or meta need rewriting for CTR
- Thin content that could expand to match competitor depth
- Missing schema or other technical hygiene

### 3. Merge
Two or more pages target overlapping queries and should consolidate.

**Signals:**
- Cannibalization (multiple pages ranking for the same query, none ranking well)
- Significant content overlap between pages
- Combined, they would outperform either alone
- Both have backlinks worth preserving

### 4. Redirect
The page has no future but has assets (links, equity) worth preserving.

**Signals:**
- No traffic, no rankings
- Holds backlinks (especially editorial ones)
- A relevant target page exists that would benefit from the equity
- Topic is still relevant but this specific page is not

### 5. Delete (and let return 404 or 410)
The page has no future and no assets worth preserving.

**Signals:**
- No traffic, no rankings, no backlinks
- Content is outdated and not worth updating
- Topic is no longer relevant
- Even thin or spam content from a previous era

Note: In most cases, return 410 (gone) for intentionally deleted content. 410 is processed faster than 404 and signals the deletion was deliberate.

---

## Scoring inputs

Pull these for every URL before deciding:

| Metric | Source | Threshold for "low" |
|---|---|---|
| Sessions (last 90 days) | Analytics | <10/month |
| Organic traffic (last 90 days) | Search console or analytics | <5/month |
| Average position for top query | Search console | >30 |
| Impressions (last 90 days) | Search console | <100/month |
| Click-through rate | Search console | <1% (when impressions exist) |
| Referring domains | Backlink tool | 0 |
| Engagement (avg time on page) | Analytics | <30 seconds |
| Last meaningful update | Manual / git | >24 months |
| Word count | Crawler | <300 (for articles) |
| Internal links in | Crawler | 0 |

A page can survive low scores on a few metrics. A page that fails on most is a delete or redirect candidate.

---

## Decision matrix

A simplified decision tree:

```
Has traffic? ─── Yes ──── Recent decay? ─── Yes ── UPDATE
        │                          │
        │                          └── No ─── KEEP
        │
        └── No ──── Has backlinks? ─── Yes ── Has relevant target? ─── Yes ── REDIRECT
                          │                            │
                          │                            └── No ─── UPDATE (rebuild)
                          │
                          └── No ──── Cannibalizing another page? ─── Yes ── MERGE
                                              │
                                              └── No ─── DELETE (410)
```

For overlapping pages, "merge" usually wins over "delete" because it preserves both link equity and any topical authority.

---

## Workflow

1. **Inventory.** Pull a complete URL list from the crawl, sitemap, and search console (some indexed pages may not be in the sitemap).
2. **Pull the metrics.** Sessions, organic, search console rank/CTR, backlinks, last-modified date, word count.
3. **Score each URL.** Use the framework. Mark a decision: Keep / Update / Merge / Redirect / Delete.
4. **Identify cannibalization clusters.** Group URLs targeting the same query. Decide which becomes the canonical, what to merge, what to redirect.
5. **Sequence the work.** Do redirects and deletes in batches. Plan updates by priority (highest-traffic-recovery potential first).
6. **Implement.** With change tracking. Re-crawl after each batch to confirm no broken redirect chains.
7. **Measure.** Track aggregate organic traffic 30, 60, 90 days post-audit.

---

## Failure patterns

- **Deleting pages with backlinks.** Always check referring domains before deleting. A redirect preserves equity at near-zero cost.
- **Updating pages that should be merged.** Two thin pages updated to medium pages still cannibalize. Merge first.
- **Merging without preserving the better URL.** Pick the merge target by which URL has stronger signals (older URL, more backlinks, better URL slug, currently better ranking), not which one has more content.
- **Mass-deleting low-traffic pages.** Some have value: fresh pages still ramping, niche pages serving a specific audience, evergreen pages with seasonal traffic. Do not bulk-delete by sessions alone.
- **Over-aggressive pruning of "old" content.** Date alone is not a delete signal. Topic relevance and intent quality are.
- **No post-audit measurement.** Without measurement, you cannot tell if the audit worked.

---

## Output format

Default output: a spreadsheet with one row per URL, plus a summary markdown report.

**Spreadsheet columns:**
- URL
- Page type (article, product, category, etc.)
- Sessions (90d), organic clicks (90d), impressions (90d), avg position
- Referring domains
- Word count
- Last modified
- Decision (keep / update / merge / redirect / delete)
- Merge target / redirect target (if applicable)
- Priority (1-5)
- Notes

**Summary report:**
1. Inventory totals (URLs by decision)
2. Cannibalization clusters identified
3. Top 20 update priorities
4. Redirect map (CSV)
5. Delete list
6. Implementation roadmap (sequenced by priority)
7. Measurement plan

---

## Reference files

- [`references/audit-template.md`](references/audit-template.md) - Spreadsheet column definitions and report template.
- [`references/cannibalization-resolution.md`](references/cannibalization-resolution.md) - Detailed methodology for resolving cannibalization clusters.

More from rampstackco/claude-skills

SkillDescription
ads-creative-developmentHow to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.
ads-performance-analyticsHow to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.
after-action-reportRun a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.
ai-content-collaborationHow humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.
analytics-strategyDesign measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.
art-directionDirect visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, write a creative direction document, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables.
backup-and-disaster-recoveryPlan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.
beta-program-managementRunning closed and open betas that produce real signal. Beta participant selection, structured feedback collection, beta-to-GA decision criteria, and the difference between soft-launch (no structure, no signal), kitchen-sink (everyone in, no actionable feedback), and structured beta (calibrated cohort, intentional feedback loops, clear graduation criteria). Triggers on beta program, alpha test, beta cohort, beta participant, beta feedback, beta to GA decision, design partner, early access program, closed beta, open beta, RC release. Also triggers when a feature is approaching launch and the team needs structured pre-GA validation, when prior betas produced noise rather than signal, or when the team has soft-launched before but wants more structured feedback this time.
brand-archetype-systemApply pre-composed aesthetic archetype defaults to jumpstart brand design work covering color, typography, layout, voice, and imagery direction. Use this skill whenever the user wants a starting point for brand visual and verbal direction, references a brand they want to design near (for example 'something like Stripe' or 'editorial like Linear'), needs to converge faster from many directions to one, or wants known-good defaults for a specific industry vertical. Triggers on archetype, design archetype, brand archetype, near to (brand), in the style of, similar aesthetic, design starting point, brand template, vertical-typical, industry-typical. Also triggers when the user has a brief and wants to map it to a known aesthetic family rather than design from first principles.
brand-discoveryRun upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration. Use this skill at the very start of a brand or website project when the user needs to understand who they're for, who they compete with, what the audience actually needs, and where the brand could plausibly stand. Triggers on brand discovery, audience research, market research, competitive scan, category research, customer research, who is this for, who are we, positioning research, intake, kickoff. Also triggers when a creative brief is requested but the upstream inputs (audience, competitors, problem space) are not yet clear.