Files
holocron/plugins/kyberforge/skills/skill-write/README.md
Defame1297 3a85632df0 refactor(kyberforge): make skill-write and skill-audit self-contained with shared resources
- Move validate.sh ownership to skill-audit/scripts/ — it is the canonical
  structural validator; skill-write now delegates Step 5 to /skill-audit
- Add skill-write/references/scripts.md and deployment-modes.md for progressive
  disclosure of package runner patterns and plugin cache isolation rules
- Fix skill-audit Step 1 cross-skill path reference (was repo-absolute, now
  skill-relative); add manual fallback for sandboxed/Bash-denied contexts
- Scope Step 2 "read every file" to exclude binaries and unreferenced files
- Fix new-skill.sh next-steps output to reference /skill-audit instead of
  the removed validate.sh
- Remove stale Dependencies section from skill-audit README; flip dependency
  arrow — skill-write depends on skill-audit, not vice versa

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-22 19:35:10 +00:00

1.6 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

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