Defame1297
193c40106d
Both validate.bats and new-skill.bats constructed SCRIPT using $(dirname "$BATS_TEST_FILENAME"), which resolves to tests/ — causing every test to fail with file-not-found. Fixed to use $BATS_TEST_DIRNAME/../scripts/ to reach the actual scripts/ directory. Also clarifies that bats-support/bats-assert must be installed from the repo root (not the skill root) to match where the tests load them from, and adds text language tags to three output-template code blocks in skill-audit's SKILL.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
# skill-write
|
|
|
|
Author a new skill conforming to the [agentskills.io](https://agentskills.io) specification.
|
|
|
|
## What it does
|
|
|
|
1. Scaffolds a full skill directory from annotated templates
|
|
2. Guides filling in `SKILL.md` and supporting files
|
|
3. Validates the result against the spec
|
|
|
|
## Before you start
|
|
|
|
This skill produces its best output when you arrive with rich context:
|
|
|
|
- Run `/grill-me` to 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 — requires bats-support and bats-assert in the repo root's `tests/test_helper/` (see skill-audit's `tests/README.md` for setup) |
|
|
|
|
## Placement
|
|
|
|
Skills can be installed in two locations:
|
|
|
|
| Type | Path |
|
|
|------|------|
|
|
| Direct (available immediately) | `~/.agents/skills/<name>/` |
|
|
| Plugin (installed via marketplace) | `plugins/<plugin>/skills/<name>/` |
|
|
|
|
## Spec reference
|
|
|
|
[agentskills.io specification](https://agentskills.io/specification.md)
|