Files

Defame1297 3290b93640 fix(kyberforge): align skill factory with agentskills.io spec on directory rules

Move test infrastructure (validate.bats, new-skill.bats) from scripts/ to
tests/ — the spec defines scripts/ as executable code agents can run, so
test files don't belong there. Add tests/README.md placeholders with
bats-support dependency declaration.

Update skill-audit to permit tests/ and flag other unlisted directories,
add scripts/ purpose check, and add /skill-improve near-miss exclusion.
Update skill-improve and skill-write to cover tests/ in directory lists,
scaffold template, and authoring guidance.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-23 19:16:47 +00:00

1.8 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 under `tests/test_helper/`

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.8 KiB Raw Blame History