CLI Reference

All commands for the @skillreg/cli package.

npm install -g @skillreg/cli

Authentication

skillreg setup

Interactive wizard: authenticate via browser, create/select an org, configure agent and scope.

skillreg setup

skillreg login

Authenticate via browser (device flow) or paste a token.

skillreg login [--api-url <url>]

Option	Description	Default
--api-url <url>	API base URL	http://localhost:3000

skillreg whoami

Display the authenticated user and current organization.

skillreg whoami [--json]

Skills

skillreg init

Scaffold a new skill directory with a SKILL.md template.

skillreg init <name>

skillreg init code-reviewer

skillreg push

Package and publish a skill to the registry.

skillreg push <directory> [options]

Option	Description	Default
--org <slug>	Target organization	from config
--name <name>	Skill name	directory name
--bump <level>	Auto-bump version (patch, minor, major)	—
--json	JSON output	—

skillreg push ./my-skill --bump patch

skillreg propose

Submit a local SKILL.md change as a collaboration proposal instead of publishing immediately.

skillreg propose <directory> --title <title> --intent <intent> [--org <slug>] [--json]

Option	Description	Default
--title <title>	Short summary of the proposed change	—
--intent <intent>	Why the change should be reviewed	—
--org <slug>	Target organization	from config
--json	JSON output	—

skillreg propose ./my-skill --title "Clarify retries" --intent "Explain retry behavior"

skillreg proposals

List collaboration proposals for a skill.

skillreg proposals @<org>/<skill> [--json]

skillreg proposal

Show one proposal in detail by ID. The org is resolved from --org or your CLI config.

skillreg proposal <proposalId> [--org <slug>] [--json]

skillreg push-all

Push all skill directories found in the current folder (excludes symlinks).

skillreg push-all [options]

Option	Description	Default
--org <slug>	Target organization	from config
--bump <level>	Auto-bump version for all skills	—

skillreg pull

Download and install a skill for an AI agent.

skillreg pull @<org>/<skill>[@<version>] [options]

Option	Description	Default
--agent <agent>	Target agent: claude, codex, cursor, all	claude
--scope <scope>	Install scope: project, user	project
-o, --output <dir>	Custom output directory	—
--json	JSON output	—

skillreg pull @acme/code-reviewer --agent all --scope user

skillreg pull-all

Pull all skills from an organization.

skillreg pull-all [options]

Option	Description	Default
--org <slug>	Source organization	from config
--agent <agent>	Target agent	claude
--scope <scope>	Install scope	project

skillreg list

List all skills in an organization.

skillreg list [--org <slug>] [--json]

skillreg info

Show detailed information about a skill.

skillreg info @<org>/<skill> [--json]

skillreg search

Search for skills across the registry (public, no auth required).

skillreg search <query> [--json]

skillreg search testing

skillreg local

List skills installed locally (symlinks, directories, .md files).

skillreg local [--agent <agent>] [--scope <scope>] [--json]

Tokens

skillreg token create

Create a new API token.

skillreg token create <name> [--scope <scope>] [--json]

Option	Description	Default
--scope <scope>	Token scope: read, write, admin	write

skillreg token list

List all tokens for the current organization.

skillreg token list [--json]

skillreg token revoke

Revoke a token by ID.

skillreg token revoke <tokenId>

Collaboration Notes

The collaboration MVP is limited to SKILL.md content only. Proposals keep the current official version in frontmatter, a reviewer assembles a single candidate in the web app, then publishes one official version from that candidate.

Environment Variables

skillreg env set

Set an environment variable for a skill.

skillreg env set <skill> <key> <value>

skillreg env set code-reviewer API_KEY sk-abc123

skillreg env list

List environment variables for a skill.

skillreg env list <skill>

skillreg env delete

Delete an environment variable.

skillreg env delete <skill> <key>

Configuration

skillreg config

Get or set CLI configuration values.

skillreg config [options]

Option	Description	Default
--api-url <url>	Set API base URL	—
--org <slug>	Set default organization	—
--default-agent <agent>	Set default agent	—
--default-scope <scope>	Set default scope	—

Global Options

Flag	Description
--json	Output in JSON format (all commands)
--help	Show help for a command
--version	Show CLI version

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments
3	Authentication required
4	Not found
5	Conflict (e.g. version exists)
6	Validation error
7	Network error
8	Permission denied