> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masterskills.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# masterskills publish

> Publish a skill folder interactively — manifest shown, approval asked, then upload.

```bash theme={"dark"}
masterskills publish [path]

masterskills publish ./skills/review-checklist --org acme
```

The one-shot publish for humans: packages the folder, shows the full manifest — target `@org/slug`, version bump, file list, total size, and every secret-excluded file — asks for confirmation, then uploads and publishes. `path` defaults to the current directory.

Agents use the split flow instead — [`prepare`](/cli/prepare) then [`publish-draft`](/cli/publish-draft) — so the approval step is explicit in the conversation.

## Options

| Option                          | Effect                                                                          |
| ------------------------------- | ------------------------------------------------------------------------------- |
| `--org <org>`                   | Target namespace, e.g. `@acme`; defaults to this device's organization          |
| `--slug <slug>`                 | Registry slug; defaults to the SKILL.md frontmatter `name`                      |
| `--name <name>`                 | Display name                                                                    |
| `--desc <description>`          | Description                                                                     |
| `--public`                      | Make the skill public — default is always **private**                           |
| `--group <kit>` / `--kit <kit>` | File the published skill into a kit, creating it if missing                     |
| `-y, --yes`                     | Skip the confirmation prompt — for [CI pipelines](/guides/publish-from-ci) only |

## Requirements and limits

* The folder must contain a `SKILL.md` at its root.
* Slugs are lowercase letters, digits, and dashes.
* Package limits: 100 MB total, 50 MB per file.
* You must be a member of the target organization.

## Behavior worth knowing

* **Versioning is automatic** — integer versions bump when content changes; the target version is part of the manifest you confirm.
* **Secret scanning runs twice** — secret-looking files are excluded client-side and reported in the manifest; the server's authoritative scan rejects findings with a `422` before any version is created. See [Trust & approvals](/concepts/trust).
* **Adopt-on-publish** — publishing a folder that lives in an agent's global skills directory moves it into the central store and links it back, so it updates like any registry skill from then on. Repo-local folders are never touched.