spm

Skills Package Manager: install and manage skills using GitHub

Install (global)

macOS / Linux:

curl -fsSL "https://spm.exastudio.io/install" | bash

Windows (PowerShell):

curl -fsSL https://raw.githubusercontent.com/exa-studio/spm/main/install.ps1 -o install.ps1
powershell -ExecutionPolicy Bypass -File install.ps1

After install you can run spm from anywhere. The script tries /usr/local/bin and falls back to ~/bin on macOS or ~/.local/bin on Linux if needed. On Windows it installs to %USERPROFILE%\\bin and adds it to the user PATH.

Start here (spm init)

spm init

What it does:

• creates skill-package.json
• creates the skills directory (default .skills/)
• adds .skills/ to .gitignore

Add and install skills (spm add/install)

Add and install a skill:

spm install owner/repo:skill@ref

Or use a direct SKILL.md URL:

spm install https://github.com/owner/repo/blob/main/skills/skill/SKILL.md

Install all dependencies from the manifest:

spm install

Install targets (project or global):

spm install --target codex-project
spm install -g

Repo structure

The skill must live here:

skills/<skill-name>/SKILL.md

Example repo:

repo/
  skills/
    web-design-guidelines/
      SKILL.md

Search skills (spm search)

spm search "agent"

Helps you find packages in the registry and pick the right one.

List and remove (spm list / spm remove)

List skills in the project:

spm list

Remove a skill:

spm remove owner/repo:skill

Build and dev install

Release build:

./scripts/build.sh

Local build:

./scripts/build-dev.sh

Dev install:

./scripts/install-dev.sh