SkillRegDocumentation
Dashboard

Getting Started

Go from zero to publishing your first AI skill in under 5 minutes.

1Install the CLI

npm install -g @skillreg/cli

2Sign up & log in

Run the setup wizard. It opens your browser for authentication, creates your first organization, and configures the CLI.

skillreg setup

Alternatively, log in with a token created from the dashboard:

skillreg login

3Create a skill

A skill is a folder with a SKILL.md file that teaches an AI agent how to perform a task.

skillreg init my-skill

This creates:

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

Edit SKILL.md with your instructions, then publish:

4Publish your skill

skillreg push ./my-skill

The CLI reads the version from SKILL.md frontmatter, packages the folder, and uploads it. To bump the version:

skillreg push ./my-skill --bump patch

5Collaborate with proposals (optional MVP workflow)

If multiple contributors work on the same skill, submit a proposal instead of publishing directly. The proposal carries your local SKILL.md plus the current official version from frontmatter.

skillreg propose ./my-skill --title "Clarify retries" --intent "Explain retry behavior"

A reviewer then opens the skill’s Collaboration page in the web app, selects multiple non-overlapping proposals into one candidate, and publishes a single official version.

MVP limitation: collaboration only merges SKILL.md, not arbitrary multi-file packages.

6Install a skill

From any project, pull a skill and it lands in the right place for your agent:

# For Claude Code (default)
skillreg pull @your-org/my-skill

# For all agents at once
skillreg pull @your-org/my-skill --agent all

# Install globally (user scope)
skillreg pull @your-org/my-skill --scope user

Install paths

AgentProject scopeUser scope
Claude Code.claude/skills/{name}/~/.claude/skills/{name}/
Codex.codex/skills/{name}/~/.codex/skills/{name}/
Cursor.cursor/skills/{name}/~/.cursor/skills/{name}/

SKILL.md format

A skill is defined by a single SKILL.md file with YAML frontmatter:

---
name: my-skill
description: "What this skill does"
metadata:
  author: "Your Name"
  version: "1.0.0"
  tags:
    - testing
    - typescript
env:
  - name: API_KEY
    description: "API key for the service"
    required: true
---

# My Skill

Instructions for the AI agent go here...

Next steps