Defame1297
3c35f2fbd5
- Rewrite assets/templates/tests/README.md with correct repo-root context and SKILL_NAME placeholder in bats run command (was: `bats tests/`, wrong CWD) - Add sed substitution for tests/README.md in new-skill.sh so SKILL_NAME is replaced in scaffolded test docs; test added to new-skill.bats (red→green) - Remove /write-eval reference from skill-improve SKILL.md; reword as direct action since the skill does not exist in the kyberforge plugin - Remove self-referential README.md rows from skill-audit and skill-improve Files tables to match template and skill-write convention 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>/ |