skilldex

skillpm install

Install a skill from the Skilldex registry or a local directory.

Usage

skillpm install <skill-name>[@version]
skillpm install <local-path>

Arguments

| Argument | Description | |---|---| | skill-name | The name of a skill in the registry | | skill-name@version | Install a specific version | | local-path | Install from a local directory (must contain a valid SKILL.md) |

Flags

| Flag | Default | Description | |---|---|---| | --scope | global | Where to install: global, shared, or project | | --dry-run | — | Show what would be installed without installing | | --force | — | Overwrite an existing install of the same version |

Examples

# Install the latest version globally
skillpm install forensics-agent

# Install a specific version
skillpm install forensics-agent@1.2.0

# Install into the current project
skillpm install forensics-agent --scope project

# Install from a local path
skillpm install ./my-skill

# Preview what would happen
skillpm install forensics-agent --dry-run

What happens on install

  1. The registry is queried for the skill metadata
  2. The skill archive is downloaded and verified
  3. The skill is validated against the spec
  4. The skill files are written to the target scope directory
  5. If --scope project, the skill is recorded in skilldex.json

Exit codes

| Code | Meaning | |---|---| | 0 | Success | | 1 | Skill not found | | 2 | Validation failed | | 3 | Network error |