skillsctl install

Install a skill from the registry

Synopsis

Download a skill from the registry and write it to the local skills directory.

By default skills install to the directory configured as skills_dir (typically ~/.claude/skills). Use —project to install into a specific project’s .claude/skills/ instead, or —skills-dir to override the target for a single invocation.

—project takes an optional value, so a path must be attached with an equals sign (—project=/path/to/repo). Passing it bare (—project) installs into the current directory.

skillsctl install <name[@version]> [flags]

Examples

  # Install the latest version
  skillsctl install git-commit

  # Pin a version and verify the digest
  skillsctl install git-commit@1.2.0 --digest sha256:abc123...

  # Install into the current project (writes to ./.claude/skills/)
  skillsctl install git-commit --project

  # Install into a specific project directory (note the '=')
  skillsctl install git-commit --project=/path/to/repo

Options

      --digest string          Expected content digest in sha256:... form; install aborts if the downloaded content does not match
      --force                  Overwrite an existing skill directory
  -h, --help                   help for install
      --project string[="."]   Install to <path>/.claude/skills; when used without a value, installs into the current directory
      --skills-dir string      Override the configured skills directory for this install

Options inherited from parent commands

      --api-url string            Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
      --credentials-path string   Credentials file path (for testing)

skillsctl install