fix(skill-author): resolve audit findings from post-#8 review

- Remove implementation-focused sentence from description (was not user-intent
  language per agentskills.io spec)
- Move source_keys template comment under metadata: block to match Step 5's
  instruction; contradicted agents scaffolding before reading Step 5
- Add Step 6 to new-skill.sh next-steps (populate references/sources.md);
  renumber validate step to 7 — script was missing the sources step entirely

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

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

@@ -7,8 +7,7 @@ description: >
   audit findings", "update based on 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. Authors and refines
-  skills following the agentskills.io specification. Do not use for read-only review — use
+  acted on — even if they don't say "improve" explicitly. Do not use for read-only review — use
   /skill-audit instead. Do not use to author agent definition files.
 allowed-tools: Bash Read Write Edit
 metadata:

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

@@ -28,14 +28,11 @@ description: >
 #   author: your-name
 #   version: "1.0"
 #   category: general
-# Optional. Arbitrary key-value map. Common keys: author, version, category.
-# No restrictions on keys or values.
-
 #   source_keys:
 #     - source-slug-one
 #     - source-slug-two
-# Optional. Populated when this skill was built from /research output.
-# Lists slugs from references/sources.md that informed this file.
+# Optional. Arbitrary key-value map. Common keys: author, version, category.
+# source_keys: populated when built from /research output. Lists slugs from references/sources.md.
 # Also add source_keys to each references/*.md file that was informed by research.
 
 # allowed-tools: Bash Read Write

plugins/kyberforge/skills/skill-author/scripts/new-skill.sh

@@ -85,4 +85,5 @@ echo "  2. Add scripts to scripts/ if needed (or delete the directory)" >&2
 echo "  3. Add docs to references/ if needed (or delete the directory)" >&2
 echo "  4. Add resources to assets/ if needed (or delete the directory)" >&2
 echo "  5. Add tests to tests/ if the skill has scripts (or delete the directory)" >&2
-echo "  6. Validate: run /skill-audit on $TARGET" >&2
+echo "  6. Populate references/sources.md with research sources, or delete it" >&2
+echo "  7. Validate: run /skill-audit on $TARGET" >&2