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 |
| 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 | <skill> <pairs...> | Set environment variables for a skill | --org |
| skillreg env list | [skill] | List environment variables | --org |
| skillreg env delete | <skill> <keys...> | Delete environment variables | --org |
| 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