Skill Cleanup
Clean up the canonical skill library and installed agent roots without losing recoverability.
Debian/Linux variant: ../../platforms/linux/skills/skill-cleanup/SKILL.md.
Required Context
Read before acting:
<user-home>\OneDrive\01 SKILLS\.agents\skills\skill-authoring\SKILL.md
<user-home>\OneDrive\01 SKILLS\.agents\skills\skill-router\SKILL.md
<user-home>\OneDrive\01 SKILLS\.agents\machines.toml
<user-home>\OneDrive\01 SKILLS\.agents\default-profile.toml
Cleanup Rules
- Never permanently delete skills; move them to
_removed/<yyyy-MM-dd>/. - Always archive old installed copies before overwriting or removing.
- Do not archive canonical skills until the user confirms a report.
- Installed-root pruning may proceed when the user has clearly approved a lean profile.
- Do not treat on-demand skills as useless just because they are not installed.
- Do not run
dotagents sync.
Analysis Labels
Use one primary label per item:
| Label | Meaning |
|---|---|
DEFAULT |
Should stay installed in coding agents. |
ON-DEMAND |
Useful, but should not load by default. |
DUPLICATE |
Functionally overlaps another skill; name the survivor. |
BROKEN |
Missing required files, bad frontmatter, dead paths, or parse/load failure. |
STALE |
Old and no evidence of use, but not enough to delete without review. |
REMOVE-CANDIDATE |
Safe to archive after confirmation. |
KEEP |
Functional and should remain canonical. |
Workflow
- Inventory canonical and installed roots from
machines.toml. - Inspect skill names, frontmatter,
SKILL.md, and referenced files as needed. - Check evidence of active use only within machine roots and config roots allowed
by
skill-authoring. - Produce a report before canonical archiving.
- After confirmation, archive remove candidates and update installed roots.
- Regenerate
INDEX.md. - Update
skill-routerif categories, names, or defaults changed. - Update
default-profile.tomlwhen default membership changes. - Propagate installed profile changes to enabled machines; continue and report if a remote machine is unreachable.
Report Requirements
Prefer tables:
| Path | Label | Reason | Referenced By | Recommended Action |
|---|
Recommended actions:
KEEPMAKE ON-DEMANDINSTALL DEFAULTMERGE INTO <skill>ARCHIVE AFTER CONFIRMATIONRENAME
Lean Default Bias
Default-installed skills should stay small and high-signal:
skill-routerskill-createskill-addskill-updateskill-cleanupskill-removepostplan-uploadvisual-explainer- core coding/debug/review skills
- core Cloudflare/local platform skills the user repeatedly uses
Treat default-profile.toml as the source of truth for this default baseline.
Media, writing, document, presentation, Azure, Supabase, and Vercel skills are normally on-demand unless the user promotes one.
Machine-specific values in this document use privacy placeholders.