SkillHub

remove

Remove installed skills and their subscriptions — deletes symlinks, the store entry, and lockfile entries.

skillhub remove removes installed skills and their subscriptions. It deletes the symlinks, the entry in the local store, and the lockfile entries.

Alias: rm.

Synopsis

skillhub remove [name…] [--global] [--dry-run] [--discard-modified]

Flags

FlagDescription
--global, -gRemove from the machine-global scope
--dry-runShow what would change without touching anything
--discard-modifiedDelete store skills that carry local edits

Examples

skillhub remove tokens-workflow
skillhub rm old-skill --global

JSON output

With --json, the data object contains:

  • scope (project | global), dryRun (bool).
  • removed[] — each { ref, name, version }.
  • modified[] — installed skills whose store content carries local edits; each { ref, name, version, storeDir, incomingVersion? }. Present on a --dry-run preview too, where it names what the real run would stop over, so a preview never promises a deletion the real run declines.
  • gitignore (schema-optional) — { action: extended | unchanged | skipped, reason?: no-managed-block | malformed-block | not-a-git-repo | global-scope | dry-run, added[] }: the managed block is only ever extended, never narrowed, so removing a skill does not un-ignore a directory another skill may still use. See install.

On this page