install
Install skills, whole registries, or skillsets into the current scope — each ref becomes a subscription.
skillhub install installs skills, whole registries, or skillsets into the
current scope. Each ref becomes (or replaces) a subscription recorded in the
lockfile. With no refs, it reconciles your existing subscription set — the
fresh-clone path.
Aliases: add, i.
Synopsis
skillhub install [ref…] [--global] [--agent <ids>] [--copy] [--dry-run] [--pin] [--tag <range|tag>] [--[no-]follow] [--exclude <names>]Flags
| Flag | Description |
|---|---|
--global, -g | Install into the machine-global scope |
--agent, -a <ids> | Agent ids to fan out to (comma-separated, or * for all) |
--copy | Copy skills instead of linking them |
--dry-run | Show what would change without touching anything |
--pin | Pin to the exact version given in the ref |
--tag <range|tag> | Range or dist-tag applied when the ref has no version qualifier |
--[no-]follow | Registry installs: auto-include future skills (default: true). --no-follow freezes the member list at install time |
--exclude <names> | Registry installs: skill names to exclude (comma-separated) |
Examples
skillhub install @studio/design-systems/tokens-workflow
skillhub install @studio/design-systems --no-follow --exclude legacy-skill
skillhub install sh:vercel-labs/agent-skills/changelog
skillhub install # reconcile existing subscriptions (fresh clone)JSON output
With --json, the data object contains:
scope(project|global),dryRun(bool),upToDate(bool).added[],updated[],removed[],unchanged[]— each item{ ref, name, version, previousVersion? }.copyMode[]— skill names that fell back to copy.agents[].