CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-cleaner

Consolidates redundant documentation while preserving all valuable content; keeps a doc set truthful after things change. Modes: (1) POST-CHANGE GOVERNANCE — when code, scripts, config, env vars, ports, paths, deployment, auth, tests, or a documented procedure changed; also "which docs are now wrong", "check docs for inconsistencies", "过时的命令/路径", "文档同步". Use it even when the user mentions only the change and never the docs — updating them is part of the change, not optional cleanup. (2) CONSOLIDATION — "clean up docs", "documentation bloat", "reduce documentation sprawl", "consolidate documentation", "too many doc files", "merge redundant docs", "merge these docs", "文档太多/太乱", multiple files covering the same topic, or documentation exceeding 500 lines across multiple files on similar topics. Finds stale copies of a fact changed in only one place, values that should never have been persisted (counts, totals, "N items", restated summaries), rival definitions that drift apart, and orphaned cross-references.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

An unusually rigorous, deeply actionable procedure whose commands, validation gates, and measured failure modes are excellent — but it pays for that with a ~790-line body that buries the operational core under persuasive justification and keeps detail inlined that its own references/ directory pattern should absorb. The workflow and command craft are near-best-case; conciseness and file structure are the clear weak points.

Suggestions

Cut the rhetorical justification and repetition (the archive procedure restated in Mode 2, the self-certifying-check argument made in both Phase 3 and Phase 4 step 1, the 'why this ordering matters' asides) to bring the body closer to procedure + commands; target roughly half the current length.

Move the detailed Verifying material (ripgrep flag behavior, git grep limits, lychee calibration) and the Mode 2 phase-by-phase detail into reference files like the existing value_analysis_template.md, keeping SKILL.md as a signed one-level-deep overview.

Repair the preservation-check table: the paragraphs between the 'Keep, merged' row and the Condense/Delete rows (lines 705–714) break the markdown table, so those rows lose their header — convert the interleaved prose to a note below the table or restructure as a list.

DimensionReasoningScore

Conciseness

The body runs ~790 lines / 49 KB with several padded sections: the archive rationale is restated across Mode 1 and Mode 2, Phase 4 step 1 carries long meta-commentary ("What this list can and cannot do", "Those two are a floor"), and the renumbering section spends three paragraphs justifying why two scopings fail. It never explains concepts Claude already knows — nearly everything is non-obvious, measured operational detail — so it is above anchor 1, but it is not 'mostly efficient' either; a careful edit could cut 30–40% (persuasive framing, repeated statements like the self-certifying-check argument appearing in both Phase 3 and Phase 4) without losing actionable content.

2 / 5

Actionability

Guidance is copy-paste executable throughout: exact `rg -U -F ... --no-ignore --hidden -g '!.git'` commands, the `git show HEAD~1:<path>` recovery forms with the subdirectory variant, lychee invocations with the `--root-dir` caveat, a working python3 one-liner, and decision tables (dispositions, mode selection, preservation-check methods). Placeholders like `"<the exact fact string>"` are appropriate templates, and common cases (multi-line facts, count-word patterns in English and Chinese) each get a specific command.

5 / 5

Workflow Clarity

Both modes are strictly sequenced with explicit checkpoints and feedback loops: write expected counts before searching and compare as set equality, calibrate a zero against a known-present string, emit the preservation list before the rewrite, run the preservation check as a gate, and get agreement before deletion (with an explicit stop-and-report rule when running unattended). This is a destructive/batch workflow and validation is pervasive, so the missing-validation cap does not apply.

5 / 5

Progressive Disclosure

Both referenced files exist and are one level deep (`references/value_analysis_template.md` at line 353, `references/delivery-entry-replay.md` at lines 158 and 610), but they cover only 187 lines against a ~790-line body: the entire Verifying/ripgrep/link-checker apparatus and the Mode 2 phase detail are inlined material that belongs in reference files. There is also a formatting defect — the preservation-check table is interrupted by multi-paragraph prose (lines 705–712), splitting the Condense and Delete rows (713–714) from their header so they render as loose text. Good headers keep this above anchor 2, but 'content that should be separate is inline' fits anchor 3 better than 4.

3 / 5

Total

15

/

20

Passed

Description

96%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.

A model description: third-person, dense with natural trigger phrases in two languages, explicitly separating two modes with concrete 'what' and 'when' for each. The only deduction is the deliberately broad post-change trigger, which trades distinctiveness for recall — a defensible choice but one that overlaps the change-handling space.

DimensionReasoningScore

Specificity

"Consolidates redundant documentation while preserving all valuable content" plus "Finds stale copies of a fact changed in only one place, values that should never have been persisted (counts, totals, 'N items', restated summaries), rival definitions that drift apart, and orphaned cross-references" — multiple concrete actions with comprehensive coverage of what the skill detects and does across both modes. Not 4: there are no minor gaps; the specific finding types are enumerated outright.

5 / 5

Completeness

Both halves are explicit: the 'what' (consolidate, preserve valuable content, keep a doc set truthful, the four enumerated finding types) and the 'when' (two labeled mode trigger lists, including the edge case "Use it even when the user mentions only the change and never the docs"). This matches the anchor-5 pattern of concrete trigger phrases attached to a clear capability statement, not the anchor-4 'when could be more specific'.

5 / 5

Trigger Term Quality

Extensive natural phrasings users would actually say: "clean up docs", "documentation bloat", "too many doc files", "merge redundant docs", "merge these docs", "which docs are now wrong", "check docs for inconsistencies", plus non-English variants ("过时的命令/路径", "文档太多/太乱") and situational triggers ("multiple files covering the same topic", "documentation exceeding 500 lines"). Coverage including synonyms well exceeds the anchor-4 example.

5 / 5

Distinctiveness Conflict Risk

The niche (documentation truthfulness and consolidation) is clear and the trigger vocabulary is doc-specific, but Mode 1 claims "Use it even when the user mentions only the change and never the docs" — code, scripts, config, env vars, ports, paths, deployment, auth, tests — which is a broad claim overlapping any change-handling skill. Mostly distinct with minor overlap risk fits anchor 4; not 5 because of that catch-any-change trigger, not 3 because nothing here is generic enough to grab unrelated skills on its own.

4 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (812 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

daymade/claude-code-skills

Path

daymade-docs/docs-cleaner/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.