docs-cleaner
Consolidates redundant documentation while preserving all valuable content. This skill should be used when users want to clean up documentation bloat, merge redundant docs, reduce documentation sprawl, or consolidate multiple files covering the same topic. Triggers include "clean up docs", "consolidate documentation", "too many doc files", "merge these docs", or when documentation exceeds 500 lines across multiple files covering similar topics.
Install with Tessl CLI
npx tessl i github:fernandezbaptiste/claude-code-skills --skill docs-cleaner90
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
89%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 with excellent trigger term coverage and completeness. It clearly defines when to use the skill with multiple natural language triggers and even includes a quantitative threshold. The main weakness is that the specific actions could be more detailed beyond just 'consolidates' - describing the actual operations performed would strengthen specificity.
Suggestions
Add 2-3 more specific concrete actions to improve specificity, e.g., 'identifies duplicate content, merges overlapping sections, removes outdated information, creates unified reference documents'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (documentation) and a primary action (consolidates redundant documentation, preserving content), but lacks multiple specific concrete actions. It doesn't detail how consolidation happens (e.g., 'identifies duplicates, merges sections, removes outdated content'). | 2 / 3 |
Completeness | Clearly answers both what ('Consolidates redundant documentation while preserving all valuable content') and when ('should be used when users want to clean up documentation bloat, merge redundant docs...') with explicit trigger phrases and even a quantitative threshold (500 lines). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'clean up docs', 'consolidate documentation', 'too many doc files', 'merge these docs', 'documentation bloat', 'documentation sprawl'. These are realistic phrases users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on documentation consolidation/cleanup with distinct triggers. Unlikely to conflict with general documentation writing skills or code-related skills due to specific focus on redundancy reduction and merging. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with excellent workflow clarity and appropriate conciseness. The four-phase approach with explicit checkpoints and anti-patterns table demonstrates thoughtful design. The main weakness is the lack of concrete, executable examples - the skill describes the process conceptually but doesn't show specific commands for file operations, content extraction, or consolidation.
Suggestions
Add concrete examples of commands or code for file discovery (e.g., `find . -name '*.md' | xargs wc -l` or similar)
Include a specific before/after example showing actual content transformation, not just line count metrics
Provide executable snippets for updating references (e.g., sed commands or script examples for link updates)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, with no unnecessary explanations of concepts Claude would already know. Every section serves a clear purpose with minimal padding. | 3 / 3 |
Actionability | Provides good structural guidance with tables and checklists, but lacks concrete executable examples. The workflow describes what to do conceptually rather than providing specific commands or code snippets for file operations. | 2 / 3 |
Workflow Clarity | Clear four-phase workflow with explicit sequencing. Includes a verification checklist before finalizing and addresses error prevention through the anti-patterns table. The destructive operation (deletion) is preceded by analysis phases. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections that progress logically from discovery to execution. References external template file appropriately for detailed criteria. Content is appropriately scoped for a single SKILL.md file. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.