- Add bats-core, bats-support, bats-assert as git submodules under tests/ - Add tests/run-bats.sh — discovers and runs all *.bats files in the repo - 17 tests for skill-audit/scripts/validate.sh: valid skill, --help, optional dirs, backtick-quoted placeholder exclusion, boundary checks (500 lines / 1024 chars), and failure cases (missing SKILL.md, name mismatch, placeholders, non-executable scripts, interactive prompts, invalid name formats, no args) - 16 tests for skill-write/scripts/new-skill.sh: scaffold structure, name substitution, numbers in name, /skill-audit reference in next-steps, and failure cases (uppercase, consecutive/leading/trailing hyphens, missing dest, existing target, no args) 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 |
Placement
Skills can be installed in two locations:
| Type | Path |
|---|---|
| Direct (available immediately) | ~/.agents/skills/<name>/ |
| Plugin (installed via marketplace) | plugins/<plugin>/skills/<name>/ |