| name | skill-cleaner |
| description | Maintenance utility for the skill bundle itself. Use to audit and tidy installed skills — detect duplicate or overlapping descriptions, overly long descriptions that risk the skill-listing budget truncation, broken frontmatter, and dead/unused skills. Run after each major phase and before release, or whenever /doctor or /context shows skill-description truncation. Keeps autonomous skill triggering reliable. |
Skill Cleaner (bundle housekeeping)
Adapted from the claude-skill-cleaner approach (steipete/YuzuruS). Claude Code's
skill-listing budget is ~1–2% of context and silently truncates descriptions on overflow —
which quietly breaks triggering. This skill keeps the bundle healthy.
Audit checklist
- Frontmatter validity — every SKILL.md has valid
name + description; name
matches its directory; names are unique.
- Description length — flag descriptions that are too long; the sum across all skills
must fit the listing budget. Recommend trims for the worst offenders.
- Overlap/duplication — flag skills whose descriptions trigger on the same intent.
Recommend merging or sharpening boundaries.
- Language policy —
name/description in English; flag any that drifted.
- Dead skills — list skills never referenced by any command, hook, or other skill.
- Shared includes — recommend moving repeated instructions into a
_shared/ file
referenced by skills rather than duplicated inline.
Output
A short report: PASS items, WARN items with concrete fixes, and (if asked) apply the safe
fixes (trim descriptions, fix names). Never delete a skill without explicit user approval.
Примітка (UK)
Бюджет на опис скілів у Claude Code малий і мовчки обрізається при переповненні — через що
скіли перестають автотригеритись. Цей скіл перевіряє валідність frontmatter, довжину й
дублювання описів, мовну політику та "мертві" скіли і пропонує конкретні правки.
