Skip to content

skillshub install

The install command downloads and installs a skill from a tap or GitHub repository onto your local machine. During installation, skillshub fetches the skill from GitHub, validates the SKILL.md manifest, and places the skill files into your local skills directory.

Terminal window
skillshub install <skill>

The <skill> argument can be specified in two formats:

  • Full path: owner/repo/skill-name — references a skill directly from a GitHub repository.
  • Tap shorthand: tap/skill-name — references a skill from an already-added tap.
OptionDescription
--version <version>Install a specific version of the skill instead of the latest.
--forceOverwrite the skill if it is already installed.
--dry-runSimulate the installation without writing any files to disk.
  1. Download — The skill source is fetched from the corresponding GitHub repository.
  2. Validate — The SKILL.md file is parsed and validated to ensure it conforms to the expected schema.
  3. Install — Skill files are written to the local skills directory (~/.skillshub/skills/).
  4. Register — The skill is recorded in the local manifest so it appears in skillshub list.

Install a skill from the default tap:

Terminal window
skillshub install brokad/hub/code-review

Install a specific version:

Terminal window
skillshub install brokad/hub/code-review --version 1.0.0

Force reinstall an existing skill:

Terminal window
skillshub install brokad/hub/code-review --force

Preview what would be installed without making changes:

Terminal window
skillshub install brokad/hub/code-review --dry-run