CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

56

Quality

63%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/content-refresh-system/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

92%

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

This is a strong skill description that clearly articulates specific capabilities (audits, prioritization frameworks, refresh-vs-merge-vs-delete decisions) and provides extensive trigger guidance through both keyword lists and scenario descriptions. The main weakness is potential overlap with related skills like pillar-content-architecture and editorial-qa, though the description attempts to address this by positioning itself as a 'program-level discipline'. The description uses appropriate third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: quarterly audits, refresh prioritization (which pieces, when, how deep), refresh-vs-merge-vs-delete decisions, and content lifecycle management. These are clearly defined activities rather than vague abstractions.

3 / 3

Completeness

Clearly answers both 'what' (systematic content refresh discipline with quarterly audits, prioritization, refresh-vs-merge-vs-delete decisions, lifecycle management) and 'when' (explicit trigger terms listed plus scenario-based triggers like traffic erosion and unclear refresh impact). The 'Triggers on' clause serves as an explicit 'Use when' equivalent.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including 'content refresh', 'content decay', 'content audit', 'traffic decay', 'ranking drop', 'content freshness', 'evergreen content', 'content maintenance'. Also includes scenario-based triggers like 'traffic is eroding silently' and 'teams cannot decide which pieces to refresh' which match real user language.

3 / 3

Distinctiveness Conflict Risk

The description acknowledges overlap by noting it 'builds on the refresh sections of pillar-content-architecture and editorial-qa', which helps differentiate it as a program-level discipline. However, the overlap with those related skills is inherent, and terms like 'content audit' or 'content lifecycle' could still trigger competing skills in a large skill library.

2 / 3

Total

11

/

12

Passed

Implementation

35%

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

This skill has a well-thought-out conceptual framework for content refresh programs, with good structural ideas (signal categories, prioritization matrix, depth levels, disposition decisions). However, it is severely over-written — the same concepts are restated multiple times across sections, extensive prose explains things Claude already knows, and the inline content largely duplicates what the referenced files should contain. The skill would benefit enormously from aggressive trimming and from providing concrete artifacts (templates, example logs, threshold numbers) instead of narrative descriptions.

Suggestions

Cut the content by 50-60%: remove the scope disambiguation section, the closing section, and the repeated explanations of the triaged-refresh concept. Trust Claude to understand the framework from one clear statement.

Add concrete artifacts: include an example audit log entry, a sample prioritization spreadsheet structure, specific monitoring threshold numbers (e.g., '>15% traffic drop over 30 days triggers review'), and a template for the refresh-that-did-not-work review.

Move detailed explanations to the reference files and keep SKILL.md as a lean overview — currently each section provides full detail AND points to a reference file, defeating the purpose of progressive disclosure.

Add an explicit workflow sequence with numbered steps and validation checkpoints (e.g., 'Before executing any refresh, confirm: signal documented, disposition decided, depth matched, owner assigned, capacity allocated').

DimensionReasoningScore

Conciseness

Extremely verbose. The skill repeatedly explains concepts at length that Claude already understands (what content decay is, what set-and-forget means, what a 2x2 matrix is). Nearly every section restates the same triaged-refresh framing. The 'what this skill covers' and scope disambiguation sections are lengthy and unnecessary. The closing section rehashes the entire skill. This could be cut by 60-70% without losing actionable content.

1 / 3

Actionability

The skill provides frameworks (2x2 matrix, signal categories, depth levels, disposition criteria) that are reasonably concrete for a strategic/editorial skill. However, there are no executable templates, no example audit spreadsheet structures, no sample tracking logs, no concrete threshold numbers for monitoring alerts, and no example of a completed refresh decision. The guidance is structured but remains at the 'describe the approach' level rather than 'here is exactly what to produce.'

2 / 3

Workflow Clarity

The 12-consideration framework at the end provides a checklist, and the overall flow (detect signals → audit → prioritize → decide disposition → execute → re-promote → measure) is discernible. However, there are no explicit validation checkpoints or feedback loops within the workflow. The 'refresh-that-did-not-work review' is mentioned but not structured as a clear step with criteria. The workflow is implicit across sections rather than presented as a clear sequential process.

2 / 3

Progressive Disclosure

The skill references 9 separate reference files with clear descriptions, which is good structure. However, the main SKILL.md itself is a monolithic wall of text that duplicates much of what the reference files presumably contain — each section ends with 'Detail in [reference]' but has already provided extensive detail inline. The split between overview and reference is poorly calibrated; the SKILL.md should be much leaner if it's truly pointing to reference files. Additionally, no bundle files were provided, so the references cannot be verified.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-skills
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.