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

# Skills Manager

> Install and remove the skills your agent CLIs read, without touching a dotfile

A skill is a folder of instructions an agent CLI loads when a task matches it. Every agent
reads them from its own folder in your home directory, which normally means unzipping
archives into `~/.claude/skills` by hand and remembering which agent got what.

**Tools ▸ Skills Manager** (**⇧⌘M**) does that for you, per agent.

## The window

The left column lists every agent FlowDeck supports — Claude Code, Codex, OpenCode, Cursor,
and Grok Build — with what is installed for each. An agent that has never run on this Mac has
no skills folder yet and reads **Not detected**; run it once and re-check.

Selecting an agent shows two groups.

### Included with FlowDeck

Two skills ship with the app and install in one click:

| Skill                    | What it gives the agent                                                                         |
| ------------------------ | ----------------------------------------------------------------------------------------------- |
| **FlowDeck CLI Skill**   | FlowDeck's build, run, test, simulator, and log commands                                        |
| **FlowDeck Apple Tools** | Apple platform patterns: SwiftUI, concurrency, frameworks, and the FlowDeck build and test loop |

The FlowDeck CLI Skill is what makes an agent drive FlowDeck properly instead of reaching for
`xcodebuild` and `simctl`. If an agent keeps calling Apple's tools directly, this is the first
thing to check.

### Installed Skills

Everything else in that agent's skills folder, with its name, description, and version when the
skill declares one. These are yours: FlowDeck lists them so you can see what an agent is
carrying, and removes them on request.

## Adding your own

**Add Skill** in the header takes a `.md` file or a `.zip` archive and installs it into the
selected agent's folder. FlowDeck asks for confirmation, names the skill and the agent, and
installs only for that agent — adding a skill to Claude Code does not add it to Codex.

## Removing

Every row has a remove action, and every removal is confirmed. The two FlowDeck skills say they
can be reinstalled at any time; your own skills say the removal cannot be undone, because
FlowDeck has no copy of them to put back.

<Note>
  Skills live in each agent's own home folder — `~/.claude/skills`, `~/.config/opencode/skills`,
  and so on — not inside FlowDeck. A skill you install here is available to that agent
  everywhere, including when you run it from your own terminal.
</Note>

## Keeping them current

The header's refresh button re-reads every agent's folder. Use it after installing a skill
outside FlowDeck, or after running an agent CLI for the first time so its folder exists.