csreg
Sign In

Getting Started

Everything you need to start publishing and installing Claude Code skills.

What is the Skills Registry?#

The Skills Registry is a platform for publishing, discovering, versioning, and installing Claude Code skills. It provides the infrastructure to share reusable skill packages across teams and projects.

The platform consists of three components:

  • Registry API — A REST API backed by Postgres and S3 for storing skill metadata and artifacts.
  • Web UI — A Next.js application for browsing, searching, and managing skills and teams.
  • CLI (csreg) — A command-line tool for authoring, publishing, and installing skills from the terminal.

Core Concepts#

Before diving in, it helps to understand the key building blocks of the Skills Registry.

Skills#

A skill is a named, versioned, folder-based package containing Claude Code instructions, examples, templates, and context files. The main entry point is typically a SKILL.md file that provides the core instructions for Claude Code. Skills are the fundamental unit of sharing in the registry.

Scopes#

A scope is a namespace prefix for skills, typically corresponding to a team slug. Skills are identified by the combination of scope and slug, written as @scope/slug (for example, @backend/code-reviewer). Scopes prevent naming collisions and make it clear who owns a skill.

Versions#

Each version is an immutable snapshot of a skill's file tree. Versions follow semantic versioning (semver) conventions such as 1.2.0 or 2.0.0-beta.1. Every version has a status that progresses through a defined lifecycle: draft (in progress), published (available for installation), or yanked (deprecated and hidden from new installs).

Channels#

Channels are named, mutable pointers to specific versions. Common channel names include latest, stable, and canary. The latest channel is automatically updated whenever a new version is published. Channels let consumers pin to a stability tier rather than a specific version number.

Skill Types#

Skills come in four types, each installed to a different location in your project:

  • command — Slash commands for Claude Code. Installed to .claude/commands/.
  • context — Background context and guidelines. Installed to .claude/context/.
  • template — File templates and scaffolding. Installed to .claude/templates/.
  • composite — Multi-purpose skills combining several types. Installed to .claude/skills/.

Quick Start#

Follow these steps to go from zero to your first published skill.

1. Install the CLI — Install the csreg CLI globally via npm:

npm install -g @agent-nexus/csreg

2. Sign in — Authenticate via the web UI or through the CLI:

csreg login

3. Create or join a team — Teams provide the scope namespace for your skills. Create one from the web UI or ask a team admin to invite you.

4. Initialize a skill — Scaffold a new skill directory:

csreg init my-skill

This creates the following structure:

my-skill/
my-skill/
  SKILL.md    # Skill manifest (YAML frontmatter) + instructions

5. Publish to the registry — Push your skill from within the skill directory:

cd my-skill && csreg push

Tip

Run csreg validate before pushing to catch manifest errors, missing entry files, or size limit violations early.

6. Install in a project — Pull the skill into any Claude Code project:

csreg pull @scope/my-skill

Info

Replace @scope with your team's slug. For example, if your team slug is backend, the full identifier would be @backend/my-skill.