Files

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

1003 B

Raw Blame History

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

Runs validate.sh from skill-write for structural checks (name format, description length, line count, placeholder detection, script rules)
Reads all files in the skill directory
Applies qualitative checks across seven dimensions
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.

1003 B Raw Blame History