Skills Audit

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 — custom skills directory (default: ~/.workbuddy/skills/)
• --golden — custom golden list (default: references/golden-list.md)
• --output — custom report output path

2. Interpret the report

The report classifies each skill into one of three categories:

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/

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)