Skills Audit#

Audit all installed WorkBuddy skills, classify them, and generate a cleanup report.

Workflow#

1. Run the audit script#

bash

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:

StatusMeaningAction[OK] ApprovedMatches the golden listKeep[!] ReviewNot in golden list, not platform-specificManually review[X] Platform: Designed for Clawdbot/Moltbot/OpenClawCandidate 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)#

bash

rm -rf ~/.workbuddy/skills/<skill-dir>

Classification Rules#

1. Golden list match: If the skill name or directory matches an entry in references/golden-list.md, it is Approved.
2. 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.
3. Otherwise: Classified as Unknown — requires manual review.

Bundled Resources#

• scripts/audit_skills.py — Python script that performs the scan and generates the report
• references/golden-list.md — Canonical list of approved skills (edit this to add/remove approved skills)