Installing Skills

Pull skills from the SkillReg registry and install them for Claude Code, Codex, Cursor, and other AI agents. Supports pinned versions and scopes.

Pull a Skill

The skillreg pull command downloads a skill from the registry and installs it into the appropriate agent directory. You can reference a skill in several formats:

@org/name — latest version from a specific organization
@org/name@1.2.0 — exact version
@org/name@^1.0.0 — semver range (resolves to the best match)
name — short format, uses your default organization

skillreg pull<skill>

Download and install a skill from the registry.

Flag	Description	Default
--version <version>	Specific version (overrides version in reference)	—
-o, --output <dir>	Custom output directory	—
--agent <agent>	Target agent: claude, codex, cursor, all	claude
--scope <scope>	Install scope: project, user	project
--no-env	Skip the environment variables wizard	—

Terminal

# Pull latest version
$ skillreg pull @my-team/react-testing

  Pulling react-testing@latest from @my-team...
  ✓ Installed to .claude/skills/react-testing

# Pull a specific version
$ skillreg pull @my-team/react-testing@1.2.0

  Pulling react-testing@1.2.0 from @my-team...
  ✓ Installed to .claude/skills/react-testing

# Pull with semver range
$ skillreg pull @my-team/react-testing@^1.0.0

  Resolving react-testing@^1.0.0 from @my-team...
  → Resolved to 1.3.2
  Pulling react-testing@1.3.2 from @my-team...
  ✓ Installed to .claude/skills/react-testing

# Install for all agents
$ skillreg pull @my-team/react-testing --agent all

  Pulling react-testing@latest from @my-team...
  ✓ Installed to .claude/skills/react-testing
  ✓ Installed to .codex/skills/react-testing
  ✓ Installed to .cursor/skills/react-testing

Semver ranges

All standard semver ranges are supported: ^1.0.0 (compatible), ~1.2.0 (patch-level), >=1.0.0 (minimum), and more. The CLI fetches all available versions and resolves the best match locally.

Semver Resolution

When you specify a version range instead of an exact version, the CLI queries the registry for all published versions of the skill, then uses Node.js semver resolution to find the highest version that satisfies your range. The resolved version is displayed before the download begins.

If no published version matches the range, the CLI exits with an error and lists the available versions to help you adjust.

Environment Variables Wizard

Some skills declare environment variables in their SKILL.md frontmatter (under the env: key). When you pull such a skill, the CLI launches an interactive wizard that prompts you to enter a value for each variable.

Required variables must be filled in; the wizard aborts if you skip one.
Optional variables can be left blank. If a default value is declared, pressing Enter uses it.
Values are stored locally in ~/.skillreg/env/<org>/<skill>.env and are never uploaded to the registry.

If the SKILL.md does not declare an env: section but references environment variable patterns (like $MY_API_KEY) in its content, the CLI auto-detects them and prompts you as well.

Use --no-env to skip the wizard entirely.

Pull All Skills

The skillreg pull-all command downloads every published skill from an organization and installs them locally. Each skill is pulled at its latest version.

skillreg pull-all

Pull all skills from an organization.

Flag	Description	Default
--org <slug>	Organization slug	—
--agent <agent>	Target agent: claude, codex, cursor, all	all
--scope <scope>	Install scope: project, user	project

Terminal

$ skillreg pull-all --org my-team

  Pulling 4 skill(s) from @my-team...

  ✓ react-testing@1.3.2
  ✓ code-review@0.5.0
  ✓ db-migrations@2.1.0
  ✓ api-design@1.0.0

  Done: 4 pulled, 0 failed

Install Locations

Skills are installed in agent-specific directories. The exact path depends on the --agent and --scope flags:

Project scope (default)

Skills are installed relative to your current working directory, making them specific to the current project:

Claude — .claude/skills/<name>
Codex — .codex/skills/<name>
Cursor — .cursor/skills/<name>

User scope

Skills are installed in your home directory, making them available across all projects:

Claude — ~/.claude/skills/<name>
Codex — ~/.codex/skills/<name>
Cursor — ~/.cursor/skills/<name>

Using --agent all

Pass --agent all to install a skill for Claude, Codex, and Cursor simultaneously. This is useful when you want all your coding agents to share the same skill set.