diff --git a/plugins/kyberforge/skills/skill-audit/SKILL.md b/plugins/kyberforge/skills/skill-audit/SKILL.md index 5470f29..c70bebc 100644 --- a/plugins/kyberforge/skills/skill-audit/SKILL.md +++ b/plugins/kyberforge/skills/skill-audit/SKILL.md @@ -73,7 +73,7 @@ Check each pattern is appropriate and correctly formed: - No non-spec files at the skill root (e.g. META.md, extra config files outside permitted directories) - Optional directories contain real content — not just unfilled placeholder READMEs - `README.md` present and accurately describes the skill and its files -- No cross-plugin path references in SKILL.md, scripts/, references/, or assets/ — paths using `../`, `../../`, or absolute repo paths (e.g. `plugins/kyberforge/skills/...`) break when the plugin is installed to a cache; flag any found +- No cross-plugin path references in SKILL.md, scripts/, references/, or assets/ — paths using `../`, `../../`, or absolute repo paths (e.g. `plugins//skills//`) break when the plugin is installed to a cache; flag any found - `tests/` is exempt from the cross-plugin path check — test files are dev-only and may reference repo-level test infrastructure (e.g. a shared `tests/test_helper/`). This dependency must be declared in `tests/README.md`; flag if tests exist but `tests/README.md` is absent or does not document the dependency ### Formatting diff --git a/plugins/kyberforge/skills/skill-audit/scripts/validate.sh b/plugins/kyberforge/skills/skill-audit/scripts/validate.sh index a719fb7..5203bad 100755 --- a/plugins/kyberforge/skills/skill-audit/scripts/validate.sh +++ b/plugins/kyberforge/skills/skill-audit/scripts/validate.sh @@ -50,7 +50,7 @@ def ok(msg): def fail(msg): global failed - print(f"FAIL {msg}", file=sys.stderr) + print(f"FAIL {msg}") failed = True # --- Parse frontmatter --- @@ -174,6 +174,6 @@ if not failed: print("All checks passed.") sys.exit(0) else: - print("One or more checks failed.", file=sys.stderr) + print("One or more checks failed.") sys.exit(1) PYTHON diff --git a/plugins/kyberforge/skills/skill-improve/SKILL.md b/plugins/kyberforge/skills/skill-improve/SKILL.md index e55616a..f884e32 100644 --- a/plugins/kyberforge/skills/skill-improve/SKILL.md +++ b/plugins/kyberforge/skills/skill-improve/SKILL.md @@ -39,11 +39,13 @@ Read the current skill files (SKILL.md and any files in scripts/, references/, a Group signals by **root cause**, not symptom. Ask: "What single gap in the skill causes this cluster of failures?" One root cause → one fix. Do not make a separate edit for each symptom. +```text Example: - Eval fails because output format is wrong - Audit finding: no output template defined - User feedback: "I always have to ask it to format the output" -- Root cause: SKILL.md has no output format specification → one fix: add an output template +→ Root cause: SKILL.md has no output format specification → one fix: add an output template +``` ## Step 3 — Announce planned changes diff --git a/plugins/kyberforge/skills/skill-write/SKILL.md b/plugins/kyberforge/skills/skill-write/SKILL.md index c41f833..98087f0 100644 --- a/plugins/kyberforge/skills/skill-write/SKILL.md +++ b/plugins/kyberforge/skills/skill-write/SKILL.md @@ -69,7 +69,7 @@ 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`). +Rename the placeholder section heading to one that fits the skill's structure — `## Step 1`, `## Workflow`, `## Instructions`, etc. Ask of every sentence: "Would the agent get this wrong without it?" Cut anything that answers "no." diff --git a/plugins/kyberforge/skills/skill-write/assets/templates/README.md b/plugins/kyberforge/skills/skill-write/assets/templates/README.md index 38de8f6..6339f0b 100644 --- a/plugins/kyberforge/skills/skill-write/assets/templates/README.md +++ b/plugins/kyberforge/skills/skill-write/assets/templates/README.md @@ -32,16 +32,16 @@ ## Files - + | File | Purpose | |------|---------| | `SKILL.md` | Skill instructions for agents | -| `scripts/` | FILL IN: what the scripts do | -| `references/` | FILL IN: what reference docs are here | -| `assets/` | FILL IN: what static resources are here | +| `scripts/your-script.sh` | FILL IN: what this script does | +| `references/your-doc.md` | FILL IN: what this reference covers | +| `assets/your-asset.json` | FILL IN: what this asset is | +| `tests/your-test.bats` | FILL IN: what this test covers |