DOCS/
EXCAVATION/
CLI REFERENCE

CLI Commands

Reference for all available Skani CLI commands

Global Cache

Skills are cached at ~/.skani/registry/skill/<id>/. When installing, if a skill is already cached, symlinks are created in your project instead of re-downloading. Use --refresh to force a fresh download.

Core Commands

init

skani init [project-name]

Initialize a new skani.json file in the current directory.

~skani init my-project

install

skani install <GitHub URL> [--refresh]

Install a skill from GitHub. Uses global cache if available. Use --refresh to force re-download.

~skani install https://github.com/obra/superpowers/tree/main/skills/test-driven-development

install-all

skani install-all

Install all skills listed in skani.json. Useful for reproducing environments.

~skani install-all

list

skani list

List all installed skills with their versions and sources.

~skani list

remove

skani remove <skill-id>

Remove an installed skill from the project. Does not remove from global cache.

~skani remove omarchy

info

skani info <skill-id>

Display detailed information about a skill including versions and install command.

~skani info omarchy

update

skani update <skill-id>

Update an installed skill to the latest version. Always refreshes from remote.

~skani update omarchy

registry list

skani registry list

List all available kits from the remote registry.

~skani registry list

registry install

skani registry install <name> [--replace] [--refresh]

Install a kit from the remote registry. Use --replace to clear existing skills, --refresh to force re-download.

~skani registry install obra-superpowers-full --replace

cache list

skani cache list

List all skills in the global cache (~/.skani) with their sizes.

~skani cache list

cache clean

skani cache clean

Clear the entire global cache. Useful for freeing disk space or forcing fresh downloads.

~skani cache clean

Local Kit Commands

Work with local .skani.json kit files. For remote registry kits, use registry install.

kit list

skani kit list

List all available local kit files (.skani.json) in current directory.

~skani kit list

kit install

skani kit install <name> [--replace]

Install skills from a local kit file. Use --replace for clean install.

~skani kit install superpowers --replace

kit restore

skani kit restore

Restore skani.json from most recent kit install backup.

~skani kit restore