> ## 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.

# Build a kit

> Bundle skills into a named set the whole team installs with one command.

Kits turn "install these seven skills" into `masterskills add @acme/ai-team`. Any active member can build one. Concept details: [Kits](/concepts/kits).

## Through your agent

> **You:** make a Next.js kit for the team from our frontend skills
> **Agent:** Proposal — create **@acme/nextjs** (private) with:
> `@acme/nextjs-conventions` · `@acme/component-standards` · `@acme/review-checklist`
> Create it?
>
> **You:** yes
> **Agent:** Done. Anyone on the team installs it with `masterskills add @acme/nextjs`.

The agent works out candidate skills from the catalog, shows the exact kit — namespace, slug, visibility, full skill list — and creates it only after you approve.

## From the CLI

```bash theme={"dark"}
# create with contents in one go
masterskills kit create nextjs --org acme \
  --name "Next.js baseline" \
  --desc "Everything our agents should know when touching the web app" \
  --skills @acme/nextjs-conventions,@acme/component-standards,@acme/review-checklist

# curate later
masterskills kit add-skill @acme/nextjs @acme/a11y-rules
masterskills kit remove-skill @acme/nextjs @acme/review-checklist

# inspect
masterskills kit list --json
masterskills kit info @acme/nextjs --json
```

A kit holds 1–50 skills. If creation fails with `slug_taken`, the name already belongs to a skill or kit in that namespace — pick another slug.

## Publish straight into a kit

Filing a skill into a kit at publish time is one flag:

```bash theme={"dark"}
masterskills publish ./skills/edge-caching --org acme --group nextjs
```

`--group` (alias `--kit`) adds the published skill to the kit and creates the kit if it doesn't exist. When an agent does this for you, the kit step always comes *after* the approved publish — never before.

## Installing a kit

```bash theme={"dark"}
masterskills kit info @acme/nextjs --json   # see exactly what would be installed
masterskills add @acme/nextjs               # install the bundle
```

Installing a kit installs the skills you're entitled to see; a kit never widens access. Deleting a kit (admin+) never touches the skills inside it.
