AI Agent Skills

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.

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

{
  "success": true,
  "agent": "claude",
  "mode": "project",
  "version": "1.2.3",
  "path": "/path/to/skill/destination"
}

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

flowdeck ai uninstall-skill

Remove the FlowDeck skill pack for a supported agent.

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.

Overview

FlowDeck for AI

Interactive Mode (TUI)

Core Features

Command Reference

Advanced

Support

flowdeck ai install-skill

Options

JSON Output

flowdeck ai uninstall-skill

Options

Supported Agents

Install Modes

​flowdeck ai install-skill

​Options

​JSON Output

​flowdeck ai uninstall-skill

​Options

​Supported Agents

​Install Modes

flowdeck ai install-skill

Options

JSON Output

flowdeck ai uninstall-skill

Options

Supported Agents

Install Modes