@skillreg/cli

The private registry for AI agent skills.

Installation

npm install -g @skillreg/cli

Quick Start

# Interactive setup (login, org, agent, scope)
skillreg setup

# Push a skill to the registry
skillreg push ./my-skill

# Pull a skill
skillreg pull @org/skill-name

# Search for skills
skillreg search "javascript testing"

Commands

| Command | Description | |---------|-------------| | skillreg setup | Interactive onboarding wizard | | skillreg login | Authenticate via browser | | skillreg whoami | Show current user info | | skillreg init | Scaffold a new skill (SKILL.md) | | skillreg push <dir> | Push a skill to the registry | | skillreg push-all | Push all local skills | | skillreg pull <skill> | Pull a skill from the registry | | skillreg pull-all | Pull all skills from an org | | skillreg search <query> | Search for skills | | skillreg list | List skills in an org | | skillreg info <skill> | Show skill details | | skillreg local | List locally installed skills | | skillreg token | Manage API tokens (create, list, revoke) | | skillreg env | Manage org-level local env variables | | skillreg command | Manage slash commands (list, info, create, push, pull, local, update, remove) | | skillreg config | Configure CLI settings |

All commands support --json for machine-readable output.

CI/CD

The CLI reads SKILLREG_TOKEN and SKILLREG_API_URL, which lets CI jobs publish without writing ~/.skillreg/config.json.

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

For GitHub Actions, use the SkillReg action:

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

Documentation

Full documentation at app.skillreg.dev/docs

Development

pnpm install
pnpm build
pnpm dev   # watch mode