skills install
Install the Out Plane agent skill into your coding tools.
Downloads the newest release of the skill and writes it into every coding tool found
on this machine. With no flags that is all of them; --agent picks one.
--project writes into the current directory instead of your home directory, so the
skill is committed with the repository and everyone working in it gets the same one.
Restart the coding tool afterwards. None of them reload a skill on their own.
Usage
outplane skills install [flags]Flags
| Flag | Type | Description |
|---|---|---|
--agent | string | Which coding tool to act on. Defaults to every one detected on this machine. One of claude-code, cursor, codex, opencode. |
--project | bool | Act on this directory's skills folder rather than the home one, so the skill can be committed with the repository. |
--ref | string | Install a particular release of the skill, such as v0.1.0. Defaults to the newest. |
This command does not accept --team. Every other global flag applies.
Output
| Field | Type | Description |
|---|---|---|
agent | string | The coding tool. |
path | string | The skills directory acted on. |
version | string | null | The skill version now in that directory. |
changed | bool | False when it already matched, and for a dry run. |
Examples
See which tools would get it, and which version
outplane skills install --dry-run --jsonInstall it everywhere it is wanted
outplane skills installInstall it into this repository, so the team shares it
outplane skills install --agent claude-code --projectWhat to Know
- Writes files on this machine and nothing on Out Plane. No credential is used and no team is involved.
- A tool is detected by its configuration directory, so a tool that has never been opened is not found. --agent installs into one by name regardless.
- The install replaces the skill directory rather than merging into it, so a file removed upstream disappears here too.
- The running coding tool does not reload a skill on its own. Tell the user to restart it.
- --project writes into the current directory, which means the skill is committed with the repository and everyone working in it gets the same one.
Errors
Beyond 0 for success, this command exits with:
| Exit | Kind | Meaning |
|---|---|---|
1 | internal | An unexpected failure in the CLI itself. |
2 | usage | Invalid arguments, unknown flag, or client-side validation failure. |
5 | not_found | The named resource does not exist, or is not visible to this credential. |
8 | upstream | The Out Plane API returned a server error. |
The code on the error object is one of skills.no_agent_found, skills.agent_unknown, skills.no_project_dir, skills.fetch_failed, skills.write_failed. Branch on that, or on the exit status. The message is prose and changes.