skills list
Show where the agent skill is installed, and which version.
Which coding tools are on this machine, whether each has the skill, and which version.
It reads local files only and never asks what the newest release is, so it works with no network and cannot tell you whether an installed skill is out of date. It reports a skill installed through a plugin marketplace exactly as it reports one installed here, because the version is read from the skill's own file rather than from a record this command keeps.
Usage
outplane skills list [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 | |
path | string | Where its skills live. |
installed | bool | |
version | string | null | Null when it is not installed. |
Examples
What is installed where
outplane skills listRead it in a script
outplane skills list --json --fields agent,installed,versionJust this repository's copy
outplane skills list --project --jsonWhat to Know
- Local only. It reports what is on disk and never asks the repository what the newest release is, so it cannot say whether an installed skill is out of date.
- A tool with no configuration directory on this machine is left out entirely rather than reported as not installed.
- The version is read from the installed skill's own frontmatter, so a skill installed by a plugin marketplace is reported the same way as one installed here.
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. |
The code on the error object is one of skills.no_agent_found, skills.agent_unknown, skills.no_project_dir. Branch on that, or on the exit status. The message is prose and changes.