Files
holocron/plugins/kyberforge/skills/skill-write
Defame1297 6a94ccc270 test(kyberforge): add bats test suites for validate.sh and new-skill.sh
- 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>
2026-06-22 19:47:31 +00:00
..

skill-write

Author a new skill conforming to the 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

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