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,14 +1,14 @@
---
name: skill-write
description: >
Author a new skill following the agentskills.io specification — scaffold the
directory structure from annotated templates, fill in SKILL.md and supporting
files, then validate the result. Use when the user wants to create a new skill
from scratch, says "write a skill for X", "build a skill that does Y", or
"create a SKILL.md for Z", or wants to make a workflow repeatable or shareable
as a reusable command. Performs best when preceded by a grill session and
domain research. Do not use to update an existing well-formed skill, write
evals, or author agent definition files.
Use when the user wants to create a new skill from scratch, says "write a skill
for X", "build a skill that does Y", or "create a SKILL.md for Z", or wants to
make a workflow repeatable or shareable as a reusable command. Authors a new
skill following the agentskills.io specification — scaffolds the directory
structure from annotated templates, fills in SKILL.md and supporting files, then
validates the result. Performs best when preceded by a grill session and domain
research. Do not use to update an existing well-formed skill, write evals, or
author agent definition files.
allowed-tools: Bash Read Write
metadata:
category: factory