CLI Reference

These pages are generated from the same typed presentation and flag contracts used by skillset --help. Edit those contracts when command behavior changes, then run bun run docs:generate.

Author

• skillset create — Create a named Skillset repository.
• skillset draft — Preview and atomically fork a shipped skill into its draft sibling.
• skillset import — Import provider-native or Agent standards skills and plugins into source.
• skillset init — Initialize Skillset in an existing directory.
• skillset move — Preview and atomically move a skill between workspace and plugin collections.
• skillset new — Create a new plugin, skill, project agent, rule, or hook in source.
• skillset promote — Preview and atomically promote a draft skill to its shipped sibling.
• skillset rename — Preview and atomically rename an authored source path.

Build

• skillset build — Preview or write generated provider outputs.
• skillset check — Validate source, generated outputs, and CI readiness.
• skillset dev — Watch source and continuously preview or write changes.
• skillset diff — Show the generated-output plan without writing it.
• skillset update — Update provider-format snapshots and generated outputs.

Inspect

• skillset eval — List, run, and inspect portable skill evals.
• skillset explain — Explain ownership and provenance for a path.
• skillset list — List authored units and their generated outputs.
• skillset lookup — Look up schema, compatibility, and provider facts.
• skillset report — Inspect immutable operational reports.
• skillset status — Summarize workspace health and generated drift.
• skillset test — Run declared or ad hoc provider runtime tests.

Changes

• skillset change — Record and inspect source changes before release.
• skillset release — Audit, plan, apply, and amend releases.
• skillset reconcile — Reconcile a managed source/output conflict.
• skillset resolve — Repair and stage generated-output conflicts during a rebase or merge.
• skillset restore — Restore a recorded generated-output backup.

Distribute

• skillset distribute — Plan distribution-ready plugin artifacts.
• skillset marketplace — Check and update curated plugin marketplaces.

Integrate

• skillset hooks — Print and run explicit hook integrations.

For shared argument behavior, see CLI flag conventions.

Exit classes

Human, --json, and --jsonl modes use the same exit class for the same result. The shared classifier never infers a code from a message prefix.

A malformed argument value is a usage error (2); a well-formed value that does not resolve is a failure (1). For example, change show @zz exits 2 because @zz is not a hex ref, while a well-formed ref that matches no entry exits 1. Values that core validates are current exceptions and exit 1: restore backup ids and the slug names that core checks for import --name and create. Aligning them is tracked as a follow-up.

Codes 3 and 4 are command-specific and appear only when a command sets them explicitly in its result or through CliOutputError. The report command uses 3 for an unreadable owned bundle. Report and structured-output invariant failures use 4. Interactive prompt cancellation uses 130.