---
title: "skillset release"
description: "The Skillset release command can audit, plan, apply, and amend releases."
---

> 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 release

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

<a id="skillset-release"></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).

Audit, plan, apply, and amend releases.

## `skillset release amend`

Amend applied release history.

### Usage

```text
skillset release amend <@ref> [--ref <ref>] [--reason <text>|--reason-file <path>|--reason -] [--json] [--root <path>]
```

### Options

| Option | Meaning |
| --- | --- |
| `--json` | Emit exactly one versioned finite JSON result document. |
| `--reason <value>` | Provide change or release reason text, with '-' meaning stdin. |
| `--reason-file <value>` | Read change or release reason text from a file. |
| `--ref <value>` | Select a change or release record by reference. |
| `--root <value>` | Select the repository root; defaults to cwd or Git root according to the route. |

## `skillset release apply`

Apply a planned release.

### Usage

```text
skillset release apply [--yes] [--json] [--root <path>]
```

### Options

| Option | Meaning |
| --- | --- |
| `--json` | Emit exactly one versioned finite JSON result document. |
| `--root <value>` | Select the repository root; defaults to cwd or Git root according to the route. |
| `--yes` | Confirm a fully specified plan-first mutation without prompting. |

## `skillset release audit`

Audit release and changelog state.

### Usage

```text
skillset release audit [--json] [--root <path>]
```

### Options

| Option | Meaning |
| --- | --- |
| `--json` | Emit exactly one versioned finite JSON result document. |
| `--root <value>` | Select the repository root; defaults to cwd or Git root according to the route. |

## `skillset release plan`

Plan versions and changelog updates.

### Usage

```text
skillset release plan [--json] [--root <path>]
```

### Options

| Option | Meaning |
| --- | --- |
| `--json` | Emit exactly one versioned finite JSON result document. |
| `--root <value>` | Select the repository root; defaults to cwd or Git root according to the route. |

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