From 97e56c55e607c814f31d48d2391f0344d87b2899 Mon Sep 17 00:00:00 2001 From: Defame1297 Date: Tue, 23 Jun 2026 20:04:24 +0000 Subject: [PATCH] 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 --- plugins/kyberforge/skills/skill-audit/SKILL.md | 2 +- plugins/kyberforge/skills/skill-improve/SKILL.md | 2 +- plugins/kyberforge/skills/skill-write/SKILL.md | 2 ++ .../kyberforge/skills/skill-write/assets/templates/README.md | 2 -- .../kyberforge/skills/skill-write/assets/templates/SKILL.md | 4 ++-- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/plugins/kyberforge/skills/skill-audit/SKILL.md b/plugins/kyberforge/skills/skill-audit/SKILL.md index f350bf3..5470f29 100644 --- a/plugins/kyberforge/skills/skill-audit/SKILL.md +++ b/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 diff --git a/plugins/kyberforge/skills/skill-improve/SKILL.md b/plugins/kyberforge/skills/skill-improve/SKILL.md index ca17988..e55616a 100644 --- a/plugins/kyberforge/skills/skill-improve/SKILL.md +++ b/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. diff --git a/plugins/kyberforge/skills/skill-write/SKILL.md b/plugins/kyberforge/skills/skill-write/SKILL.md index 7a910a8..c41f833 100644 --- a/plugins/kyberforge/skills/skill-write/SKILL.md +++ b/plugins/kyberforge/skills/skill-write/SKILL.md @@ -69,6 +69,8 @@ Open `//SKILL.md`. Replace every `FILL IN:` placeho ### Body — include only what the agent lacks +Rename `## FILL IN: ` 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:** diff --git a/plugins/kyberforge/skills/skill-write/assets/templates/README.md b/plugins/kyberforge/skills/skill-write/assets/templates/README.md index 42548a6..38de8f6 100644 --- a/plugins/kyberforge/skills/skill-write/assets/templates/README.md +++ b/plugins/kyberforge/skills/skill-write/assets/templates/README.md @@ -15,8 +15,6 @@ ## Usage -Invoke via your agent tool: - ``` /SKILL_NAME ``` diff --git a/plugins/kyberforge/skills/skill-write/assets/templates/SKILL.md b/plugins/kyberforge/skills/skill-write/assets/templates/SKILL.md index cbda594..be7f799 100644 --- a/plugins/kyberforge/skills/skill-write/assets/templates/SKILL.md +++ b/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: -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.