Files
holocron/plugins/kyberforge/skills/skill-write/README.md
Defame1297 95ba57d0d5 fix(kyberforge): address self-audit findings and update lessons
- Reorder skill-audit description to lead with 'Use when...' trigger (P3)
- Add concrete example to 'control calibration' body discipline check (P4)
- Add bats test files to README file tables for both skills
- Fix REPO_ROOT and SCRIPT paths in bats files after tests/ subdirectory removed
- Add three lessons: plugin cache isolation, spec-grounded rubrics, test file placement

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-22 20:16:24 +00:00

1.7 KiB

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
scripts/new-skill.bats Bats test suite for new-skill.sh — dev tooling, not shipped with the plugin

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