Defame1297
8598a187e4
- validate.sh: move FAIL lines and failure summary to stdout; stderr reserved for fatal script errors only (missing SKILL.md, bad args) - skill-audit SKILL.md: replace concrete plugins/kyberforge/skills/... example with abstract placeholder to fix meta-circularity - skill-write SKILL.md: rephrase placeholder section-heading instruction to remove embedded FILL IN: from a code span, clearing validator false positive - skill-improve SKILL.md: wrap Step 2 root-cause example in a text fence - skill-write assets/templates/README.md: update Files table to individual- file rows so skill-audit can verify per-file coverage Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
skill-write
Author a new skill conforming to the agentskills.io specification.
What it does
- Scaffolds a full skill directory from annotated templates
- Guides filling in
SKILL.mdand supporting files - Validates the result against the spec
Before you start
This skill produces its best output when you arrive with rich context:
- Run
/grill-meto resolve design decisions (scope, triggers, patterns) - Collect domain research, examples, and reference docs
- Know the skill name (kebab-case) and destination path
Usage
/skill-write
Files
| File | Purpose |
|---|---|
SKILL.md |
Skill instructions for agents |
scripts/new-skill.sh |
Copies annotated templates to the destination |
references/scripts.md |
Package runner table and inline dependency patterns (loaded on demand) |
references/deployment-modes.md |
Plugin vs standalone differences and cache isolation rules (loaded on demand) |
assets/templates/SKILL.md |
Annotated SKILL.md template |
assets/templates/README.md |
Annotated README template for the new skill |
assets/templates/scripts/README.md |
Placeholder for bundled scripts |
assets/templates/references/README.md |
Placeholder for reference docs |
assets/templates/assets/README.md |
Placeholder for static assets |
assets/templates/tests/README.md |
Placeholder for test files |
tests/new-skill.bats |
Bats test suite for new-skill.sh |
tests/README.md |
Setup instructions for bats-support and bats-assert test dependencies |
Placement
Skills can be installed in two locations:
| Type | Path |
|---|---|
| Direct (available immediately) | ~/.agents/skills/<name>/ |
| Plugin (installed via marketplace) | plugins/<plugin>/skills/<name>/ |