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>
This commit is contained in:
@@ -30,7 +30,7 @@ Note any structural FAILs — they will appear in the report as a `### Structure
|
|||||||
|
|
||||||
## Step 2 — Read all skill files
|
## 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
|
## Step 3 — Qualitative audit
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
**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.
|
**On scripts**: Fix and edit existing scripts freely when signals point to them.
|
||||||
|
|
||||||
|
|||||||
@@ -69,6 +69,8 @@ Open `<destination-dir>/<skill-name>/SKILL.md`. Replace every `FILL IN:` placeho
|
|||||||
|
|
||||||
### Body — include only what the agent lacks
|
### 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."
|
Ask of every sentence: "Would the agent get this wrong without it?" Cut anything that answers "no."
|
||||||
|
|
||||||
**Include:**
|
**Include:**
|
||||||
|
|||||||
@@ -15,8 +15,6 @@
|
|||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
Invoke via your agent tool:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
/SKILL_NAME
|
/SKILL_NAME
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -96,6 +96,6 @@ FILL IN: what goes here
|
|||||||
If FILL IN: condition, read `references/FILL IN: filename.md`.
|
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.
|
||||||
|
|||||||
Reference in New Issue
Block a user