Skills Audit
Audit all installed WorkBuddy skills, classify them, and generate a cleanup report.
Workflow
1. Run the audit script
python scripts/audit_skills.py
This scans ~/.workbuddy/skills/, reads each SKILL.md, and generates a skills-audit-YYYY-MM.md report.
Options:
--dir <path>— custom skills directory (default:~/.workbuddy/skills/)--golden <path>— custom golden list (default:references/golden-list.md)--output <path>— custom report output path
2. Interpret the report
The report classifies each skill into one of three categories:
| Status | Meaning | Action |
|---|---|---|
| [OK] Approved | Matches the golden list | Keep |
| [!] Review | Not in golden list, not platform-specific | Manually review |
| [X] Platform: | Designed for Clawdbot/Moltbot/OpenClaw | Candidate for removal |
3. Present findings to user
Use present_files to show the report. For platform-specific or unknown skills,
flag them and ask the user for confirmation before removing.
4. Remove redundant skills (after user confirmation)
rm -rf ~/.workbuddy/skills/<skill-dir>
Classification Rules
- Golden list match: If the skill name or directory matches an entry in
references/golden-list.md, it is Approved. - Platform detection: SKILL.md is scanned for keywords (
clawdbot,moltbot,openclaw,clawhub,CodeConductor.ai). If found and not in golden list, it is flagged as platform-specific. - Otherwise: Classified as Unknown — requires manual review.
Bundled Resources
scripts/audit_skills.py— Python script that performs the scan and generates the reportreferences/golden-list.md— Canonical list of approved skills (edit this to add/remove approved skills)
