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_SKILL_DIR}/rules/audit-checks.md
HIGH What to validate per skill
Status Rules ${CLAUDE_SKILL_DIR}/rules/audit-status.md
MEDIUM PASS/WARN/FAIL classification
Output Format ${CLAUDE_SKILL_DIR}/references/output-format.md
MEDIUM Table layout and column definitions
Edge Cases ${CLAUDE_SKILL_DIR}/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_SKILL_DIR}/rules/audit-checks.md") in parallel
-
Classify — Apply status rules from Read("${CLAUDE_SKILL_DIR}/rules/audit-status.md")
-
Render — Output table using format from Read("${CLAUDE_SKILL_DIR}/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
Related Skills
-
ork:skill-evolution — Guidance on iterating and improving skills
-
ork:quality-gates — Broader codebase quality checks