Defame1297
97e56c55e6
- skill-audit: remove contradictory skip clause in Step 2 (binary only) - skill-improve: drop redundant "Fix the root" heading; keep specific directive - skill-write: add section-rename guidance to body discipline step - template SKILL.md: make Instructions heading an explicit FILL IN placeholder - template README.md: remove "Invoke via your agent tool:" prefix to match 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>/ |