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>

plugins/kyberforge/skills/skill-write/README.md

@@ -36,7 +36,8 @@ This skill produces its best output when you arrive with rich context:
 | `assets/templates/references/README.md` | Placeholder for reference docs |
 | `assets/templates/assets/README.md` | Placeholder for static assets |
 | `assets/templates/tests/README.md` | Placeholder for test files |
-| `tests/new-skill.bats` | Bats test suite for new-skill.sh — requires bats-support and bats-assert in the repo root's `tests/test_helper/` (see skill-audit's `tests/README.md` for setup) |
+| `tests/new-skill.bats` | Bats test suite for new-skill.sh |
+| `tests/README.md` | Setup instructions for bats-support and bats-assert test dependencies |
 
 ## Placement
 

plugins/kyberforge/skills/skill-write/SKILL.md

@@ -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

plugins/kyberforge/skills/skill-write/tests/README.md

@@ -0,0 +1,28 @@
+# tests/
+
+Test files for scripts bundled with this skill.
+
+## Dependencies
+
+Tests require [bats-support](https://github.com/bats-core/bats-support) and
+[bats-assert](https://github.com/bats-core/bats-assert). The test files load
+helpers from the repo root's `tests/test_helper/`.
+
+From the repo root:
+
+```bash
+git clone https://github.com/bats-core/bats-support tests/test_helper/bats-support
+git clone https://github.com/bats-core/bats-assert tests/test_helper/bats-assert
+```
+
+Run all tests for this skill (from the repo root):
+
+```bash
+bats plugins/kyberforge/skills/skill-write/tests/
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `new-skill.bats` | Bats test suite for `scripts/new-skill.sh` |