fix(kyberforge): apply audit findings across skill factory trio

- skill-audit: promote internal-working gotcha to ## Gotchas section;
  narrow cross-plugin path check to exclude tests/ (dev-only, repo-level
  deps are expected); require tests/README.md to declare that dependency
- skill-write/skill-improve: reorder descriptions to lead with "Use when..."
  for consistency with skill-audit and the agentskills.io spec trigger pattern
- skill-write: add tests/README.md with self-contained bats setup instructions;
  remove cross-skill reference to skill-audit's tests/README.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-06-23 19:48:20 +00:00
parent 193c40106d
commit 60d1f0852c
5 changed files with 54 additions and 20 deletions

View File

@@ -1,15 +1,15 @@
---
name: skill-improve
description: >
Apply evidence-based improvements to an existing skill. Use when the user
says "improve this skill", "fix this skill based on feedback", "apply these
audit findings", or "update the skill based on this grill output". Also use
when the user provides inline feedback about a skill's behavior and wants it
applied, or when a grill session, eval run, or audit has produced findings
the user wants acted on — even if they don't say "improve" explicitly. Do
not use when the user wants a read-only review only — use /skill-audit
instead. Do not use when no improvement signals are present in the
conversation or referenced files.
Use when the user says "improve this skill", "fix this skill based on
feedback", "apply these audit findings", or "update the skill based on this
grill output". Also use when the user provides inline feedback about a skill's
behavior and wants it applied, or when a grill session, eval run, or audit has
produced findings the user wants acted on — even if they don't say "improve"
explicitly. Applies evidence-based improvements to an existing skill. Do not
use when the user wants a read-only review only — use /skill-audit instead.
Do not use when no improvement signals are present in the conversation or
referenced files.
allowed-tools: Bash Read Write Edit
metadata:
category: factory