2.13.0-beta.20). Features may change before the next stable release.Switch to stable →ak skills
ak skills remove
Remove one installed skill and its runtime record directly while preserving the shared package cache.
Use ak skills remove to delete one installed skill copy from the user Claude
plugin root.
Usage
ak skills remove <kit>/<skill>The command has no command-specific flags. Canonical references are recommended;
ak:, ake:, and akm: reference shorthands are accepted.
Deletion order and limits
If the destination directory exists, the command:
- Removes the per-skill runtime record unless
AGENTKIT_SKILL_RUNTIME=0. - Removes
~/.claude/plugins/<kit>/skills/<skill>/.
The shared ~/.agentkit/cache/<runtime-hash>/ entry is preserved. If content is
already absent, the command returns success without trying to clean an orphan
runtime record.
Removal is immediate. There is no prompt, dry-run, ownership/drift check, backup, snapshot, or rollback. If content deletion fails after runtime-record deletion, the content can remain without its record.
To recover, reinstall from the unchanged local kits source. Any preserved shared runtime cache may be reused, but it does not restore the deleted content.
Output
JSON uses kind=assets.remove with:
data.ref, data.kit, data.asset,
data.removed, data.not_installedRemoving an absent destination returns removed=false,
not_installed=true, and exit 0. Human output similarly says “nothing to
remove.”
Exit behavior
| Exit | Meaning |
|---|---|
0 | Content was removed or was already absent. |
1 | Runtime-record or content deletion failed. Missing or extra positional arguments also currently use this path. |
2 | The reference or flags were invalid. |
For malformed references, the current JSON error envelope can report
exit_code: 1 while the process exits 2.