Generated from Skillset’s CLI presentation contract. See the documentation system.
Create a new plugin, skill, project agent, rule, or hook in source.
Usage
skillset new [plugin|skill|agent|rule|hook] [name] [--id <id>] [--name <name>] [--in <container>] [--draft] [--scope repo] [--preset <preset>] [--event <event>] [--command <command> | --script <path>] [--attach <source-unit>] [--provider <provider>] [--yes] [--json] [--root <path>]Options
| Option | Meaning |
|---|---|
--attach <value> |
Attach a new adaptive hook to an existing source-unit selector; without it, new hook writes a shared definition to the source root hooks/ folder. |
--command <value> |
Set the command action for a new adaptive hook. |
--draft |
Create a new skill under the selected container’s _drafts directory. |
--event <value>... |
Select a hook event; repeat where the route permits. |
--id <value> |
Set an explicit stable source-unit id. |
--in <value> |
Select the containing plugin for a new source unit. |
--json |
Emit exactly one versioned finite JSON result document. |
--name <value> |
Set a route-specific human or stable name where the route permits it. |
--preset <value>... |
Apply a named skill preset: assets, evals, examples-file, minimal, reference-file, references, scripts, or support. |
--provider <value>... |
Constrain a new adaptive hook to a compatible provider. |
--root <value> |
Select the repository root; defaults to cwd or Git root according to the route. |
--scope <value>... |
Select the source scope; only repo is accepted. |
--script <value> |
Set the script action for a new adaptive hook. |
--yes |
Confirm a fully specified plan-first mutation without prompting. |
Examples
skillset new skill release-notes
skillset new skill release-notes --preset support --yes
skillset new rule testing --yes
skillset new hook session-banner --event SessionStart --command "echo ready" --attach plugin:tools