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	https://app.skillreg.dev

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 import-github

Preview or import a skill from a GitHub repository path containing SKILL.md.

skillreg import-github <owner/repo> [--path <path>] [--branch <ref>] [--preview]

Option	Description	Default
--org <slug>	Target organization	from config
--path <path>	Directory or SKILL.md path	repo root
--branch <ref>	Branch or ref to import	main
--name <name>	Override imported skill name	—
--version <version>	Override imported version	—
--preview	Validate and scan without publishing	—

skillreg import-github acme/agent-skills --path skills/reviewer --preview

skillreg local

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

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

Slash Commands

skillreg command list

List slash commands in an organization.

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

skillreg command info

Show one slash command and its version history.

skillreg command info <name> [--org <slug>] [--json]

skillreg command pull

Install a slash command locally for Claude, Codex, or Cursor.

skillreg command pull <name> [--org <slug>] [--version <version>] [--agent <agent>] [--scope <scope>] [--dry-run] [--json]

Option	Description	Default
--version <version>	Version to install	latest
--agent <agent>	claude, codex, cursor, or all	—
--scope <scope>	project or user	—
-o, --output <dir>	Use a custom install root directory	—
--dry-run	Show install paths without writing files	—

skillreg command pull /review-pr --org acme --agent all

skillreg command local

List slash commands tracked in the local SkillReg manifest.

skillreg command local [--org <slug>] [--agent <agent>] [--scope <scope>] [--path] [--json]

skillreg command update

Update tracked local slash commands to the latest or requested version.

skillreg command update [name] [--org <slug>] [--version <version>] [--agent <agent>] [--scope <scope>] [--force] [--dry-run] [--json]

skillreg command remove

Remove tracked local slash command files and manifest entries.

skillreg command remove <name> [--org <slug>] [--agent <agent>] [--scope <scope>] [--dry-run] [--json]

skillreg command create

Create a slash command and publish its initial version.

skillreg command create <name> --description <text> (--content <text> | --content-file <path>) [options]

Option	Description	Default
--description <text>	Command description	—
--content <text>	Command body	—
--content-file <path>	Read command body from a file	—
--version <version>	Initial version	1.0.0
--agents <list>	Comma-separated agents	claude,codex,cursor
--scope <scope>	org, project, or user	org

skillreg command push

Publish a new slash command version.

skillreg command push <name> --version <version> (--content <text> | --content-file <path>) [options]

Option	Description	Default
--version <version>	Semver version to publish	—
--content <text>	Command body	—
--content-file <path>	Read command body from a file	—
--agents <list>	Comma-separated agents	claude,codex,cursor
--scope <scope>	org, project, or user	org

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 one or more org-level environment variables.

skillreg env set <pairs...> [--org <slug>]

skillreg env set OPENAI_API_KEY=<value>

skillreg env list

List org-level environment variable metadata without values.

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

skillreg env delete

Delete one or more org-level environment variables.

skillreg env delete <keys...> [--org <slug>]

skillreg env delete OPENAI_API_KEY

skillreg env legacy

Show legacy per-skill env files that remain readable for compatibility.

skillreg env legacy [--org <slug>] [--json]

skillreg env migrate

Migrate non-conflicting legacy per-skill values into org-level storage.

skillreg env migrate [--org <slug>] [--json]

skillreg env cleanup-legacy

Preview or confirm cleanup of legacy keys already migrated to org-level storage.

skillreg env cleanup-legacy [--org <slug>] [--confirm] [--json]

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	—

CI/CD

In CI, set SKILLREG_TOKEN instead of running an interactive login. SKILLREG_API_URL can override the default API URL for staging or self-hosted environments.

SKILLREG_TOKEN=$SKILLREG_TOKEN skillreg push ./my-skill --org acme --bump patch

GitHub Actions can call the bundled SkillReg action, which runs @skillreg/cli with the same token environment contract.

- uses: Tontoon7/skillreg-app@v1
  with:
    token: ${{ secrets.SKILLREG_TOKEN }}
    org: acme
    path: ./skills/code-reviewer
    bump: patch

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