CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

content-refresh-system

Systematic content refresh discipline. Quarterly audits, refresh prioritization (which pieces, when, how deep), refresh-vs-merge-vs-delete decisions, the lifecycle that distinguishes intentional refresh from set-and-forget decay. Builds on the refresh sections of pillar-content-architecture and editorial-qa with a program-level discipline. Triggers on content refresh, content decay, content audit, refresh prioritization, content lifecycle, refresh strategy, traffic decay, ranking drop, content freshness, evergreen content, content maintenance. Also triggers when traffic is eroding silently across an aging content library, when teams cannot decide which pieces to refresh, or when refresh work is happening but the impact is unclear.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is content-refresh-system in rampstackco/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured program-level discipline: concrete thresholds and decision criteria throughout, an auditable 12-consideration framework, and exemplary progressive disclosure with nine verified one-level-deep references. The main weaknesses are repetition of the keystone framing across four sections and an unoperationalized 'piece value' axis in the otherwise strong prioritization matrix.

Suggestions

Cut one of the two restatements of the content-suite scope — paragraph three and 'What this skill covers' cover the same ground; keep the bulleted version and trim the intro to a single sentence.

Compress the keystone framing to a single appearance (the 'Refresh-everything vs refresh-nothing vs triaged-refresh' section) and reduce the closing and failure-modes sections to pointers, since they re-argue the same failure modes.

Operationalize the 'piece value (high vs low)' axis of the 2x2 matrix with concrete criteria (e.g., traffic/contribution thresholds or strategic-role tests) so the program's core prioritization judgment is executable rather than qualitative.

DimensionReasoningScore

Conciseness

The body is dense with domain expertise, but the refresh-everything/refresh-nothing framing is repeated across the intro, the keystone section, the failure modes, and the closing, and the content-suite distinction appears both in paragraph three and again in 'What this skill covers'. Mostly efficient, but it could be tightened — the repetition is more than minor, so it sits below the 4 anchor rather than at it.

3 / 5

Actionability

For an instruction-only skill the guidance is highly concrete: '90+ day window', '30-90 minutes per piece', '2-4 hours', 'drops from page 1 to page 2-3', '30 and 90 days post-refresh', '30-40% refresh allocation', plus explicit disposition criteria. The gap keeping it from a 5 is that the 2x2 matrix's central variable — 'piece value (high vs low)' — is never operationally defined, leaving the program's core prioritization judgment without thresholds.

4 / 5

Workflow Clarity

Sections follow the lifecycle in order (signals → cadence → prioritization → depth → disposition → execution → re-promotion → tracking), and real checkpoints exist: the litmus test ('what signal triggered this refresh... how will we measure whether the refresh worked?'), 30/90-day recovery tracking, the refresh-that-did-not-work review, and a 12-item checklist. A 5 would require an explicitly sequenced operational procedure for running the audit; the audit workflow is narrated ('The team pulls traffic, ranking, and recency data; reviews each piece against the signals; assigns dispositions') rather than given as ordered steps.

4 / 5

Progressive Disclosure

Each major section summarizes its topic in the body and then points to a dedicated, clearly signaled one-level-deep reference ('Detail in references/refresh-signals-checklist.md'); all nine referenced files exist in references/, and a Reference files index at the end lists each with a description. This matches the clear-overview/well-signaled-references anchor exactly.

5 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states concrete capabilities, positions the skill against its siblings in the content suite, and provides both an explicit keyword trigger list and natural scenario triggers. Third person is used throughout and there is no fluff or over-claiming despite the length.

DimensionReasoningScore

Specificity

The description names multiple concrete actions — 'Quarterly audits, refresh prioritization (which pieces, when, how deep), refresh-vs-merge-vs-delete decisions, the lifecycle that distinguishes intentional refresh from set-and-forget decay' — giving comprehensive coverage of the skill's capabilities, matching the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

Both 'what' (the discipline, audits, prioritization, dispositions, lifecycle) and 'when' (an explicit 'Triggers on...' clause plus scenario triggers) are clearly and explicitly stated, matching the anchor requiring concrete trigger phrases for both.

5 / 5

Trigger Term Quality

It lists eleven natural trigger terms ('content refresh, content decay, content audit, refresh prioritization, content lifecycle, refresh strategy, traffic decay, ranking drop, content freshness, evergreen content, content maintenance') plus three natural scenario phrasings ('traffic is eroding silently across an aging content library', 'teams cannot decide which pieces to refresh'), covering synonyms and user-voiced problem statements comprehensively.

5 / 5

Distinctiveness Conflict Risk

The description carves a clear niche — post-publish lifecycle scope — and explicitly positions against siblings ('Builds on the refresh sections of pillar-content-architecture and editorial-qa with a program-level discipline'), minimizing conflict risk with the related content-suite skills.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

rampstackco/claude-skills

Path

dist/codex/.agents/skills/content-refresh-system/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.