fix(kyberforge): apply cross-skill audit findings to skill factory trio

- skill-audit: remove contradictory skip clause in Step 2 (binary only)
- skill-improve: drop redundant "Fix the root" heading; keep specific directive
- skill-write: add section-rename guidance to body discipline step
- template SKILL.md: make Instructions heading an explicit FILL IN placeholder
- template README.md: remove "Invoke via your agent tool:" prefix to match convention

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

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

@@ -30,7 +30,7 @@ Note any structural FAILs — they will appear in the report as a `### Structure
 
 ## Step 2 — Read all skill files
 
-Read every file in the skill directory: `SKILL.md`, `README.md` (if present), all files in `scripts/`, `references/`, and `assets/`. Skip binary files and files not directly referenced from `SKILL.md`. Do not skip text files — internal consistency checks require the full picture.
+Read every file in the skill directory: `SKILL.md`, `README.md` (if present), all files in `scripts/`, `references/`, and `assets/`. Skip binary files only. Do not skip text files — internal consistency checks require the full picture.
 
 ## Step 3 — Qualitative audit
 

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

@@ -63,7 +63,7 @@ Edit any file in the skill directory that the signals point to: SKILL.md, script
 
 **Explain the why.** Reasoning-based instructions outperform rigid directives. If you find yourself writing a rule in all caps (ALWAYS/NEVER), reframe it: explain why the behavior matters so the agent can apply judgment in edge cases.
 
-**Fix the root, not the symptom.** If a signal points to a script or reference file, edit that file directly rather than adding a workaround in SKILL.md.
+If a signal points to a script or reference file, edit that file directly rather than adding a workaround in SKILL.md.
 
 **On scripts**: Fix and edit existing scripts freely when signals point to them.
 

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

@@ -69,6 +69,8 @@ Open `<destination-dir>/<skill-name>/SKILL.md`. Replace every `FILL IN:` placeho
 
 ### Body — include only what the agent lacks
 
+Rename `## FILL IN: <section-name>` to a heading that fits the skill's structure (e.g. `## Step 1`, `## Workflow`, `## Instructions`).
+
 Ask of every sentence: "Would the agent get this wrong without it?" Cut anything that answers "no."
 
 **Include:**

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

@@ -15,8 +15,6 @@
 
 ## Usage
 
-Invoke via your agent tool:
-
 ```
 /SKILL_NAME
 ```

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

@@ -96,6 +96,6 @@ FILL IN: what goes here
 If FILL IN: condition, read `references/FILL IN: filename.md`.
 -->
 
-## Instructions
+## FILL IN: <section-name (e.g. Step 1, Workflow, Instructions)>
 
-FILL IN: Add your skill instructions here. Replace this section with the skill body.
+FILL IN: Add your skill instructions here. Replace this section header and body with your skill content.