---
title: "skillset new"
description: "The Skillset new command can create a new plugin, skill, project agent, rule, or hook in source."
---

> Documentation Index
> Fetch the complete documentation index at: https://nimbus.focal.host/llms.txt
> Use this file to discover all available pages before exploring further.

# skillset new

<!-- Generated by `bun run docs:generate`; do not edit directly. -->

<a id="skillset-new"></a>

> Generated from Skillset's CLI presentation contract. See the [documentation system](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/documentation-system.md).

Create a new plugin, skill, project agent, rule, or hook in source.

## Usage

```text
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

```text
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
```

Source: https://nimbus.focal.host/skillset/reference/cli/new/index.mdx