audit-skills

audit-skills Scans all src/skills//SKILL.md files and reports compliance with OrchestKit authoring standards. Each category has individual files in rules/ and references/ loaded on-demand. Quick Reference Category File Impact When to Use Audit Checks ${CLAUDE_PLUGIN_ROOT}/skills/audit-skills/rules/audit-checks.md HIGH What to validate per skill Status Rules ${CLAUDE_PLUGIN_ROOT}/skills/audit-skills/rules/audit-status.md MEDIUM PASS/WARN/FAIL classification Output Format ${CLAUDE_PLUGIN_ROOT}/skills/audit-skills/references/output-format.md MEDIUM Table layout and column definitions Edge Cases ${CLAUDE_PLUGIN_ROOT}/skills/audit-skills/references/edge-cases.md LOW Manifest "all", orchestration skills Total: 2 rules across 2 categories Workflow Discover — Glob src/skills//SKILL.md to get full skill list Check each skill — Run all checks from Read("${CLAUDE_PLUGIN_ROOT}/skills/audit-skills/rules/audit-checks.md") in parallel Classify — Apply status rules from Read("${CLAUDE_PLUGIN_ROOT}/skills/audit-skills/rules/audit-status.md") Render — Output table using format from Read("${CLAUDE_PLUGIN_ROOT}/skills/audit-skills/references/output-format.md") Totals — Show X pass, Y warn, Z fail at bottom Quick Start bash src/skills/audit-skills/scripts/run-audit.sh Or invoke manually — Claude scans src/skills/ , applies checks, and renders the summary table. Key Decisions Decision Recommendation Manifest check "skills": "all" in ork.json means ALL skills qualify — mark YES 0 rules + refs WARN only — some orchestration skills are legitimately rules-free Broken refs WARN (not FAIL) — file may exist under a different path