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

# AI Agent Skills

> Install and remove FlowDeck skill packs for AI agents

`flowdeck ai` installs and removes the FlowDeck skill pack for an AI coding agent. The skill pack teaches the agent how to use FlowDeck's `flowdeck` CLI for Apple-platform build, run, test, simulator, device, log, and UI automation work, so the agent reaches for `flowdeck` commands instead of `xcodebuild`, `simctl`, or `devicectl`.

## flowdeck ai install-skill

Install the FlowDeck skill pack for a supported agent. The skill pack version matches the installed FlowDeck CLI version.

```bash theme={null}
# Project install (skill lives in this project)
flowdeck ai install-skill --agent codex --mode project
flowdeck ai install-skill --agent claude --mode project
flowdeck ai install-skill --agent gemini --mode project
flowdeck ai install-skill --agent pi --mode project

# User install (skill available across all projects)
flowdeck ai install-skill --agent cursor --mode user
flowdeck ai install-skill --agent opencode --mode user
flowdeck ai install-skill --agent gemini --mode user
flowdeck ai install-skill --agent pi --mode user

# JSON output
flowdeck ai install-skill --agent claude --mode project --json
```

### Options

| Option           | Short | Description                                                                             |
| ---------------- | ----- | --------------------------------------------------------------------------------------- |
| `--agent <name>` |       | Agent to install the skill for: `codex`, `claude`, `opencode`, `cursor`, `gemini`, `pi` |
| `--mode <mode>`  |       | Install mode: `user` (across all projects) or `project` (this project only)             |
| `--json`         | `-j`  | Output as JSON                                                                          |
| `--examples`     | `-e`  | Show usage examples                                                                     |

### JSON Output

With `--json`, `install-skill` reports the agent, mode, installed version, and destination path:

```json theme={null}
{
  "success": true,
  "agent": "claude",
  "mode": "project",
  "version": "1.2.3",
  "path": "/path/to/skill/destination"
}
```

<Note>
  Restart your AI agent after installing or updating the skill pack so it picks up the new skills.
</Note>

***

## flowdeck ai uninstall-skill

Remove the FlowDeck skill pack for a supported agent.

```bash theme={null}
flowdeck ai uninstall-skill --agent claude --mode project
flowdeck ai uninstall-skill --agent codex --mode user

# JSON output
flowdeck ai uninstall-skill --agent claude --mode project --json
```

### Options

| Option           | Short | Description                                                                               |
| ---------------- | ----- | ----------------------------------------------------------------------------------------- |
| `--agent <name>` |       | Agent to uninstall the skill for: `codex`, `claude`, `opencode`, `cursor`, `gemini`, `pi` |
| `--mode <mode>`  |       | Uninstall mode: `user` or `project` (must match how it was installed)                     |
| `--json`         | `-j`  | Output as JSON                                                                            |
| `--examples`     | `-e`  | Show usage examples                                                                       |

## Supported Agents

| Agent       | `--agent` value |
| ----------- | --------------- |
| Codex CLI   | `codex`         |
| Claude Code | `claude`        |
| OpenCode    | `opencode`      |
| Cursor      | `cursor`        |
| Gemini CLI  | `gemini`        |
| Pi          | `pi`            |

## Install Modes

* **`project`** — installs the skill into the current project so it applies only here. Useful when a project wants a specific FlowDeck workflow pinned to it.
* **`user`** — installs the skill into the user's agent configuration so it applies across every project for that agent.