CLI Reference
This reference is generated from packages/cli/src/Cli.ts — the same
argument router the CLI itself runs — so it lists exactly the commands and
flags that exist on this branch, nothing aspirational.
skillmaker — Skillmaker Studio CLI
Usage: skillmaker <command> [options]Global options
Section titled “Global options”| Flag | Meaning |
|---|---|
--json | Emit machine-readable JSON instead of text, on every command that produces output |
-h, --help | Show the top-level usage text |
Commands
Section titled “Commands”| Command | Purpose |
|---|---|
init | Initialize a skillmaker workspace in the current directory |
new <slug> | Create a new Skill Bundle under skills/<slug>/ |
list | List Skill Bundles by stage/substate |
status <slug> | Show one Skill Bundle’s identity, state, and event history |
reindex | Rebuild .skillmaker/studio.db from files + the journal |
fixture add <slug> <case> | Scaffold evals/fixtures/<case>/ for a bundle |
run <slug> | Run a fixture case through an ACP provider |
grade <slug> <runId> | Record a run’s grading verdict |
measurements <slug> | Show measurement cells: n, pass rate, CI, guidance |
start | Serve the viewer + API |
review request <slug> | Request review of the bundle’s current stage work |
advance <slug> | Move a bundle along the state machine (guarded) |
version record <slug> | Record a version: hash design.md + output/ |
todo add/list/done/start/drop/reopen | The journal-native todo system |
Exit codes
Section titled “Exit codes”Every command uses 0 for success and 2 for a usage error. skillmaker run additionally distinguishes 1 (task failed) from 3 (infra-error) —
see skillmaker run.
Running it
Section titled “Running it”There’s no published package yet — see
Install from source for how to run
skillmaker <command> from a checkout, and
Your first Skill Bundle for a full
walkthrough with real output.