---
# Generated by kapten-docs from the CLI's command tree. DO NOT EDIT.
title: "kapten skills"
description: "Install the Kapten agent skill and MCP servers for coding agents."
sidebar:
  label: "skills"
---

See [Coding agents](/cli/mcp) for what the skill and the MCP servers give an agent. Every command takes the [global flags](/cli/reference#global-flags).

## kapten skills install

Write the kapten agent skill of this CLI version where coding agents read skills: in the current project, or for the user with --global. Without --agent, it installs for every agent that has run on this machine. Agents: claude-code, codex, cursor, opencode, copilot.

With --mcp, it also adds two MCP servers to each agent's configuration, leaving other entries untouched: kapten (`kapten mcp serve`, with --context when given) and kapten-docs (https://docs.kapten.io/mcp). Running it again updates what it wrote.

```bash
kapten skills install [flags]
```

| Flag | Description |
| --- | --- |
| `--agent strings` | Agents to install for, comma-separated: claude-code, codex, cursor, opencode, copilot |
| `--dir string` | Project root (default: the current directory) |
| `--dry-run` | Print what would be written, and write nothing |
| `--global` | Install for the user instead of the current project |
| `--mcp` | Also add the kapten and kapten-docs MCP servers |

Examples:

```bash
kapten skills install
kapten skills install --agent claude-code --mcp
kapten skills install --global --mcp --dry-run
kapten --context work skills install --agent codex --mcp
```
