fix(kyberforge): address self-audit findings and update lessons

- Reorder skill-audit description to lead with 'Use when...' trigger (P3)
- Add concrete example to 'control calibration' body discipline check (P4)
- Add bats test files to README file tables for both skills
- Fix REPO_ROOT and SCRIPT paths in bats files after tests/ subdirectory removed
- Add three lessons: plugin cache isolation, spec-grounded rubrics, test file placement

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-06-22 20:16:24 +00:00
parent ac72898a55
commit 95ba57d0d5
6 changed files with 329 additions and 6 deletions

View File

@@ -1,13 +1,13 @@
---
name: skill-audit
description: >
Audit a skill directory against the agentskills.io specification — structural
Use when the user wants to review a skill they wrote, says "audit this skill",
"check if my skill follows best practices", "review my SKILL.md", or wants to
know if a skill is ready to ship — even if they don't use the word "audit".
Audits a skill directory against the agentskills.io specification — structural
checks plus qualitative review of description quality, body discipline, formatting,
file structure, and internal consistency. Produces a PASS/FAIL/SUGGESTION punch
list with a specific fix proposal for every FAIL. Use when the user wants to
review a skill they wrote, says "audit this skill", "check if my skill follows
best practices", "review my SKILL.md", or wants to know if a skill is ready to
ship — even if they don't use the word "audit". Do not use to run evals, fix
list with a specific fix proposal for every FAIL. Do not use to run evals, fix
application code bugs, or perform general code review unrelated to skill quality.
allowed-tools: Bash Read
metadata:
@@ -46,7 +46,7 @@ For each sentence in the body, apply: *"Would the agent get this wrong without t
- **Defaults not menus**: every decision point gives one default + one escape hatch, not a list of options
- **Why rationale**: include/exclude rules explain why, not just what
- **Control calibration**: prescriptive for fragile or critical sequences; flexible where multiple approaches are valid
- **Control calibration**: prescriptive for fragile or critical sequences (e.g. a script invocation where flag order or exact arguments must not change); flexible where multiple approaches are valid
If uncertain whether a sentence is padding or whether a control decision is correctly calibrated, read `references/body-discipline.md`.