list
List installed skills with version, scope, source, agents, copy-mode, and drift status.
skillhub list shows the skills installed in the current scope, along with each
one's version, source, the agents it's linked into, whether it's in copy mode,
and its drift status.
Alias: ls.
Synopsis
skillhub list [--global]Flags
| Flag | Description |
|---|---|
--global, -g | List the machine-global scope |
Examples
skillhub list
skillhub ls --global
skillhub list --jsonJSON output
With --json, the data object contains:
scope(project|global).skills[]— each{ name, ref, version, source, agents[], copyMode (bool), status, orphaned (bool), external (bool) }, wherestatusis one ofok,modified,store-missing,link-missing, orforeign.
Drift status
| Status | Meaning |
|---|---|
ok | The store directory is present, every agent entry delivers it, and its content is what was installed |
modified | Delivered, and the store content carries your edits — they're yours, and sync protects them |
store-missing | The lockfile records the skill but its store directory is gone |
link-missing | One or more agent directories lack the entry |
foreign | An agent directory carries an entry the CLI doesn't own |
A delivery failure outranks modified: store-missing, foreign and
link-missing mean the skill isn't usable at all, while modified means it's
usable and yours. Editing a skill in the store is supported — see
sync.