---
title: "skillset promote"
slug: "skillset/reference/cli/promote"
description: The Skillset promote command can preview and atomically promote a draft skill to its shipped sibling.
---
<!-- Generated by `bun run docs:generate`; do not edit directly. -->

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

Preview and atomically promote a draft skill to its shipped sibling.

## Usage

```text
skillset promote <draft-path> [--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. |

## Examples

```text
skillset promote .skillset/skills/_drafts/demo
skillset promote .skillset/plugins/tools/skills/_drafts/demo --yes
```