Files
holocron/plugins/kyberforge/skills/skill-audit
Defame1297 672fd25890 feat(kyberforge): replace write-skill with spec-compliant skill-write and add skill-audit
Rewrote the skill authoring factory skill from scratch against the agentskills.io
specification. Renamed write-skill → skill-write (name now matches directory per spec).

skill-write:
- Full scaffold via new-skill.sh (annotated templates for SKILL.md, README.md,
  scripts/, references/, assets/)
- validate.sh checks all spec constraints deterministically (name format/length,
  description length, placeholder detection, line count, script rules)
- SKILL.md body includes description rules, body discipline, patterns, and scripts
  guidance with "why" rationale throughout
- Templates usable standalone by agents and humans

skill-audit:
- Structural validation (via validate.sh) + seven qualitative dimensions
- Produces PASS/FAIL/SUGGESTION punch list with per-FAIL fix proposals
- Report-only: does not apply fixes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-22 18:50:00 +00:00
..

skill-audit

Audit a skill directory against the agentskills.io specification. Runs structural validation then a qualitative review across description quality, body discipline, formatting, file structure, and internal consistency.

What it does

  1. Runs validate.sh from skill-write for structural checks (name format, description length, line count, placeholder detection, script rules)
  2. Reads all files in the skill directory
  3. Applies qualitative checks across seven dimensions
  4. Outputs a PASS/FAIL/SUGGESTION punch list with a specific fix proposal for every FAIL

Usage

/skill-audit

Provide the path to the skill directory to audit when invoking.

Files

File Purpose
SKILL.md Skill instructions for agents
README.md This file

Dependencies

Requires skill-write to be installed at plugins/kyberforge/skills/skill-write/ for the structural validation step. If not present, the agent performs structural checks manually.