@agent-nexus/csreg

CLI for the Claude Skills Registry — publish, install, and manage reusable Claude skills.

Installation

npm install -g @agent-nexus/csreg

Quick Start

# Authenticate with the registry
csreg login --token <your-token>

# Initialize a new skill project
csreg init my-skill

# Validate, pack, and publish
csreg validate
csreg push

Commands

Authentication

| Command | Description | | --- | --- | | csreg login [--token <token>] | Authenticate with the Skills Registry | | csreg logout | Remove stored authentication credentials | | csreg whoami | Display the currently authenticated user |

Skill Development

| Command | Description | | --- | --- | | csreg init [dir] | Initialize a new skill project | | csreg validate [dir] | Validate a skill package | | csreg pack [dir] | Pack a skill into a tarball | | csreg push [dir] | Publish a skill to the registry |

Skill Discovery & Installation

| Command | Description | | --- | --- | | csreg search <query> | Search for skills in the registry | | csreg info <scope/name> | Display details about a skill | | csreg versions <scope/name> | List all versions of a skill | | csreg pull [ref] | Download and install a skill |

Usage

Publishing a Skill

# Create a new skill
csreg init my-skill
cd my-skill

# Edit your skill files, then validate
csreg validate

# Publish to the registry
csreg push

Installing a Skill

# Install a specific skill
csreg pull @scope/skill-name

# Install a specific version
csreg pull @scope/[email protected]

# Install all skills listed in .claude/skills.json
csreg pull --all

Searching for Skills

# Search by keyword
csreg search "code review"

# Filter by type
csreg search "linting" --type prompt

# Limit results
csreg search "testing" --limit 5

Bulk Operations

# Validate all skills in .claude/skills/
csreg validate --all

# Push all skills in .claude/skills/
csreg push --all

Configuration

The CLI stores its configuration in ~/.config/csreg/config.json.

You can override settings with environment variables:

| Variable | Description | | --- | --- | | CSREG_API_URL | Override the registry API URL | | CSREG_TOKEN | Provide an auth token (skips stored credentials) |

License

MIT