Files

Defame1297 193c40106d fix(kyberforge): fix bats SCRIPT path and clarify test helper install location

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>

2026-06-23 19:31:08 +00:00

1.9 KiB

Raw Blame History

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.md and 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-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

1.9 KiB Raw Blame History