audit-skills
Audits all OrchestKit skills for quality, completeness, and compliance with authoring standards. Use when checking skill health, before releases, or after bulk skill edits to surface SKILL.md files that are too long, have missing frontmatter, lack rules/references, or are unregistered in manifests.
Resources
4Install
npx skillscat add yonatangross/orchestkit/audit-skills Install via the SkillsCat registry.
SKILL.md
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 | rules/audit-checks.md |
HIGH | What to validate per skill |
| Status Rules | rules/audit-status.md |
MEDIUM | PASS/WARN/FAIL classification |
| Output Format | references/output-format.md |
MEDIUM | Table layout and column definitions |
| Edge Cases | references/edge-cases.md |
LOW | Manifest "all", orchestration skills |
Total: 2 rules across 2 categories
Workflow
- Discover — Glob
src/skills/*/SKILL.mdto get full skill list - Check each skill — Run all checks from
rules/audit-checks.mdin parallel - Classify — Apply status rules from
rules/audit-status.md - Render — Output table using format from
references/output-format.md - Totals — Show
X pass, Y warn, Z failat bottom
Quick Start
bash src/skills/audit-skills/scripts/run-audit.shOr 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 skillsork:quality-gates— Broader codebase quality checks
Categories
Install
npx skillscat add yonatangross/orchestkit/audit-skills Install via the SkillsCat registry.