audit-skills

Original：🇺🇸 English

Translated

1 scripts

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.

2installs

Sourceyonatangross/orchestkit

Added on2026-03-25

NPX Install

npx skill4agent add yonatangross/orchestkit audit-skills

SKILL.md Content

View Translation Comparison →

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

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

audit-skills

NPX Install

Tags

SKILL.md Content

audit-skills

Quick Reference

Workflow

Quick Start

Key Decisions

Related Skills