Skip to content

skillmaker new

skillmaker new <slug> [--name <name>]

Scaffolds a new Skill Bundle at skills/<slug>/ and appends one bundle.created event to the journal. Requires an initialized workspace (skillmaker init first).

FlagMeaning
--name <name>Display name for the bundle; defaults to a title-cased version of <slug>
--jsonEmit machine-readable JSON instead of text

<slug> must be kebab-case; it becomes the bundle’s directory name and is immutable — it’s the key every fixture, run, and journal event refers back to.

skills/<slug>/
bundle.json
design.md
stations.json
research/.gitkeep
evals/
risk-map.md
fixtures/.gitkeep
output/.gitkeep
runs/.gitkeep
skillmaker: created bundle my-first-skill
Terminal window
skillmaker new frame-the-problem --name "Frame the Problem"

The Skill Bundle documents every file this scaffolds.