- Move validate.sh ownership to skill-audit/scripts/ — it is the canonical structural validator; skill-write now delegates Step 5 to /skill-audit - Add skill-write/references/scripts.md and deployment-modes.md for progressive disclosure of package runner patterns and plugin cache isolation rules - Fix skill-audit Step 1 cross-skill path reference (was repo-absolute, now skill-relative); add manual fallback for sandboxed/Bash-denied contexts - Scope Step 2 "read every file" to exclude binaries and unreferenced files - Fix new-skill.sh next-steps output to reference /skill-audit instead of the removed validate.sh - Remove stale Dependencies section from skill-audit README; flip dependency arrow — skill-write depends on skill-audit, not vice versa Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.6 KiB
1.6 KiB
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 |
Placement
Skills can be installed in two locations:
| Type | Path |
|---|---|
| Direct (available immediately) | ~/.agents/skills/<name>/ |
| Plugin (installed via marketplace) | plugins/<plugin>/skills/<name>/ |