skills update

writesrepeatable--dry-runno sign-in

Fetches the newest release and rewrites it wherever the skill is already installed.

Only tools that already have it are touched. Deciding that a tool should have the skill is what skills install is for, and quietly adding one here would be a surprise.

Usage

outplane skills update [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.

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 what would change

outplane skills update --dry-run --json

Update every installed copy

outplane skills update

Update one tool

outplane skills update --agent cursor

What to Know

Only tools that already have the skill are touched. Use outplane skills install to add it somewhere new.
changed is false where the installed version already matched, and the command still exits 0.
The coding tool has to be restarted before it reads the new copy.

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.not_installed, 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.