CLI Reference
Complete reference of all SkillReg CLI commands, flags, and options. Covers push, pull, search, login, token management, and configuration.
Global Options
These options work with all commands:
--json— Output results in JSON format. Useful for scripting and CI/CD pipelines.--help— Show help for any command.--version— Show CLI version.
Commands
Complete reference of all available CLI commands, their arguments, and options.
| Command | Arguments | Description | Key Options |
|---|---|---|---|
| Authentication & Setup | |||
| skillreg login | — | Authenticate with SkillReg via browser or token | --token, --api-url |
| skillreg setup | — | Interactive setup wizard (auth, org, agent, scope) | — |
| skillreg config | — | Configure CLI settings | --org, --api-url, --default-agent, --default-scope |
| skillreg whoami | — | Show current authenticated user info | — |
| Publishing | |||
| skillreg init | [name] | Initialize a new skill with a SKILL.md template | --description, --author, --tags |
| skillreg push | <directory> | Package and push a skill to the registry | --org, --name, --version, --bump, --tag, --dry-run |
| skillreg push-all | — | Push all local skills to the registry | --org |
| skillreg import-github | <owner/repo> | Preview or import a GitHub repo path containing SKILL.md | --path, --branch, --preview, --version, --org |
| Installing | |||
| skillreg pull | <skill> | Pull and install a skill from the registry | --version, -o, --agent, --scope, --no-env |
| skillreg pull-all | — | Pull all skills from an organization | --org, --agent, --scope |
| Discovery | |||
| skillreg search | <query> | Search public skills in the registry | — |
| skillreg info | <skill> | Show detailed info about a skill | — |
| skillreg list | — | List all skills in an organization | --org |
| skillreg local | — | List locally installed skills | --agent, --scope, --path |
| Environment Variables | |||
| skillreg env set | <pairs...> | Set org-level environment variables | --org |
| skillreg env list | — | List org-level env metadata without values | --org, --json |
| skillreg env delete | <keys...> | Delete org-level environment variables | --org |
| skillreg env legacy | — | Show readable legacy per-skill env files | --org, --json |
| skillreg env migrate | — | Migrate non-conflicting legacy values to org-level storage | --org, --json |
| skillreg env cleanup-legacy | — | Preview or confirm cleanup of migrated legacy keys | --org, --confirm, --json |
| Slash Commands | |||
| skillreg command list | — | List slash commands in an organization | --org, --json |
| skillreg command info | <name> | Show one slash command and its version history | --org, --json |
| skillreg command pull | <name> | Install a slash command locally for Claude, Codex, or Cursor | --org, --version, --agent, --scope, --output, --dry-run |
| skillreg command local | — | List slash commands tracked in the local manifest | --org, --agent, --scope, --path, --json |
| skillreg command update | [name] | Update tracked slash commands to the latest or requested version | --org, --version, --agent, --scope, --force, --dry-run |
| skillreg command remove | <name> | Remove tracked local slash command files and manifest entries | --org, --agent, --scope, --dry-run |
| skillreg command create | <name> | Create a slash command and publish its first version | --description, --content, --content-file, --agents, --scope |
| skillreg command push | <name> | Publish a new slash command version | --version, --content, --content-file, --agents, --scope |
| API Tokens | |||
| skillreg token create | — | Create a new API token | --name, --scopes, --org |
| skillreg token list | — | List all API tokens | --org |
| skillreg token revoke | <id> | Revoke an API token | --org |
Exit Codes
All CLI commands return standard exit codes that can be used in scripts and CI/CD pipelines:
0— Success1— General error (network failure, auth error, unexpected issue)2— Validation error (invalid SKILL.md, bad arguments, schema mismatch)
JSON output for scripting
Combine --json with exit codes for robust CI/CD integration. JSON output returns structured data you can parse with jq or any JSON parser.
See Also
Each command group has a dedicated documentation page with detailed examples and usage patterns:
- Getting Started — Installation, setup wizard, and first skill walkthrough
- Publishing Skills —
init,push,push-all, version bumping, dry runs - Installing Skills —
pull,pull-all, multi-agent installs, scopes, semver resolution - Discovery —
search,info,list,local - SKILL.md Format — Full specification of the frontmatter, environment variables, and content structure