Agent-Skills.md

Agent Skills: 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.

UncategorizedID: yonatangross/orchestkit/audit-skills

Repository

yonatangross/orchestkit
yonatangrossLicense: MIT
13314

Install this agent skill to your local

pnpm dlx add-skill https://github.com/yonatangross/orchestkit/tree/HEAD/src/skills/audit-skills

Skill Files

Browse the full folder contents for audit-skills.

Download Skill

Loading file tree…

src/skills/audit-skills/SKILL.md

Skill Metadata

Name
audit-skills
Description
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.

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

  1. Discover — Glob src/skills/*/SKILL.md to get full skill list
  2. Check each skill — Run all checks from Read("${CLAUDE_SKILL_DIR}/rules/audit-checks.md") in parallel
  3. Classify — Apply status rules from Read("${CLAUDE_SKILL_DIR}/rules/audit-status.md")
  4. Render — Output table using format from Read("${CLAUDE_SKILL_DIR}/references/output-format.md")
  5. 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