2.13.0-beta.20). Features may change before the next stable release.Switch to stable →ak skills
ak skills list
List installed and locally available skills, understand installed-copy precedence, and consume the assets.list envelope.
Use ak skills list to inspect the union of user-installed skill content and
skills available in the local kits tree.
Usage
ak skills listOptions
| Flag | Default | Description |
|---|---|---|
--kit <kit> | Empty | Keep one exact kit directory name. |
--tag <tag> | [] | Accepted as a repeatable or comma-separated value, but the current skill resolver does not apply this filter. |
The documented syntax has no positional arguments. The current implementation ignores extra positional tokens; do not rely on that behavior.
Despite the short help saying “installed,” the result also contains locally
available skills. Installed and available records with the same canonical
reference are deduplicated, with the installed copy winning. Results are sorted
by <kit>/<skill>.
Source roots are AGENTKIT_PLUGIN_DIR or ~/.claude/plugins for installed
content and AGENTKIT_KITS_DIR or ./kits for available content. A missing root
is treated as empty. The command does not contact the AgentKit registry.
Output
Human stdout shows NAME, DESCRIPTION, SOURCE, and STATUS columns. Status
is installed or available.
JSON success uses kind=assets.list; data.skills[] contains:
kit, name, version, description, tags,
runtime.has_python, runtime.has_node, runtime.packages,
installedMetadata parsing is best-effort. Invalid or absent optional metadata can produce empty fields rather than a command failure.
Effects and exits
The command is local, read-only, noninteractive, and has no cache mutation, auth, entitlement, preview, or backup behavior.
| Exit | Meaning |
|---|---|
0 | Listing completed, including an empty result. |
1 | An existing install or kits root could not be read. |
2 | A flag could not be parsed. |