From ork
Audits OrchestKit SKILL.md files for quality, completeness, and authoring standards compliance. Surfaces issues like excessive length, missing frontmatter, absent rules/references, or unregistered manifests before releases or bulk edits.
How this skill is triggered — by the user, by Claude, or both
Slash command
/ork:audit-skillsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
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.
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.
| 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
src/skills/*/SKILL.md to get full skill listRead("${CLAUDE_SKILL_DIR}/rules/audit-checks.md") in parallelRead("${CLAUDE_SKILL_DIR}/rules/audit-status.md")Read("${CLAUDE_SKILL_DIR}/references/output-format.md")X pass, Y warn, Z fail at bottombash src/skills/audit-skills/scripts/run-audit.sh
Or invoke manually — Claude scans src/skills/, applies checks, and renders the summary table.
| 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 |
ork:skill-evolution — Guidance on iterating and improving skillsork:quality-gates — Broader codebase quality checksnpx claudepluginhub yonatangross/orchestkit --plugin orkAudits SKILL.md files against the AgentOps template with a three-pass process: structural hygiene via heal-skill, 8 content-discipline checks, and an advisory 0-30 productization rubric. Read-only; reports findings without modifying files.
Audits Claude Code skills for quality, compliance, delegation patterns, and maintainability. Run after creating skills, before releases, or for periodic checks.
Audits skill quality against routing, progressive loading, and verification criteria. Produces health reports with per-skill ratings and a Gate outcome.