ak skills
ak skills show
Inspect one installed or locally available skill record and interpret its best-effort runtime metadata.
Use ak skills show before a local content install to inspect one skill's
metadata.
Usage
ak skills show <kit>/<skill>The command has no command-specific flags. Use canonical references in scripts;
ak:, ake:, and akm: reference shorthands are accepted.
Resolution
The command first checks installed content under AGENTKIT_PLUGIN_DIR or
~/.claude/plugins. If absent, it checks AGENTKIT_KITS_DIR or ./kits, trying
both the named directory and an ak--prefixed source directory. The installed
copy wins when both exist.
This is local metadata lookup. It does not contact the AgentKit registry, validate entitlement, verify a runtime cache, or prove that the selected runtime can invoke the skill.
Metadata is best-effort: skill.yaml supplies version, description, and runtime
packages when it parses; SKILL.md frontmatter can supply description and tags.
Missing or invalid optional metadata can appear as empty values rather than an
error.
Output
Human stdout reports reference, name, kit, version, description, tags, runtime
languages/packages, and installed or available state.
JSON success uses kind=assets.show; data is the skill object:
kit, name, version, description, tags,
runtime.has_python, runtime.has_node, runtime.packages,
installedPackage names are declarations, not a lockfile attestation or vulnerability report.
Effects and exits
The command is read-only, local, noninteractive, and has no cache, preview, backup, apply, or force behavior.
| Exit | Meaning |
|---|---|
0 | An installed or available local record was shown. |
1 | Local lookup failed unexpectedly. Missing or extra positional arguments currently also use this path. |
2 | The reference or flags were invalid. |
5 | Neither an installed nor available record was found. |
For exits 2 and 5, the current JSON error envelope can contain
exit_code: 1; trust process status.