# Registry

> Skill registry for distributing skills, agents, prompts, output styles, and config files across devices, projects, and teams. Use when installing, distributing, syncing, or managing skills from a catalog — including installing an output style or statusline config on a new machine.

- Skill: `orakitine/registry` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add orakitine/registry`
- Raw SKILL.md: https://api.skillmd.com/api/skills/orakitine/registry/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: orakitine (https://skillmd.com/u/orakitine)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/orakitine/registry

---


# Purpose

A catalog-based distribution system for skills, agents, prompts, output styles, and config files. The `./registry.yaml` stores pointers (local paths and GitHub URLs) to where assets live. Nothing is fetched until you ask for it. Pull specific items on demand. Entries whose assets need `settings.json` activation (an output style's `outputStyle`, a statusline's `statusLine`) carry a `settings:` fragment that `use` merges automatically.

## Variables

REGISTRY_REPO_URL: https://github.com/orakitine/registry.git   # Remote URL for the registry repo

## Workflow

1. **Parse Command**
   - Determine which subcommand from `$ARGUMENTS`
   - IF: "install" → THEN: first-time setup
   - IF: "add" → THEN: register a new entry
   - IF: "use" → THEN: pull from source
   - IF: "push" → THEN: push local changes back
   - IF: "remove" → THEN: remove from catalog
   - IF: "list" → THEN: show catalog with install status
   - IF: "sync" → THEN: re-pull all installed items
   - IF: "search" → THEN: find by keyword
   - Example: "/registry use browser globally" → Route to use reference, name=browser, target=global

2. **Route to Reference**
   - Read the matching reference file, then execute its steps
   - Each reference handles its own catalog read (after git pull)
   - For source format details, references delegate to `./references/source-formats.md`
   - Example: "use" → Read and execute `./references/use.md`
   - Tool: Read

## References

### Install (First-Time Setup)

- IF: User wants to set up the registry on a new device
- THEN: Read and execute `./references/install.md`
- EXAMPLES:
  - "/registry install"

### Add Entry

- IF: User wants to register a new skill, agent, prompt, output style, or config in the catalog
- THEN: Read and execute `./references/add.md`
- EXAMPLES:
  - "/registry add deploy skill from https://github.com/org/repo/blob/main/skills/deploy/SKILL.md"
  - "/registry add browser-qa agent from ~/Documents/toolbox/agents/browser-qa.md"
  - "/registry add skippy output style from https://github.com/org/repo/blob/main/output-styles/skippy.md"

### Use (Pull from Source)

- IF: User wants to pull or refresh a skill from the catalog
- THEN: Read and execute `./references/use.md`
- EXAMPLES:
  - "/registry use browser"
  - "/registry use browser-qa globally"
  - "/registry use statusline globally" (config — also merges its `settings:` fragment)

### Push (Local to Source)

- IF: User improved a skill locally and wants to update the source
- THEN: Read and execute `./references/push.md`
- EXAMPLES:
  - "/registry push browser"

### Remove

- IF: User wants to remove an entry from the catalog
- THEN: Read and execute `./references/remove.md`
- EXAMPLES:
  - "/registry remove old-skill"

### List

- IF: User wants to see the full catalog with install status
- THEN: Read and execute `./references/list.md`
- EXAMPLES:
  - "/registry list"

### Sync (Re-Pull All)

- IF: User wants to refresh all installed items from their sources
- THEN: Read and execute `./references/sync.md`
- EXAMPLES:
  - "/registry sync"

### Search

- IF: User is looking for a skill but doesn't know the exact name
- THEN: Read and execute `./references/search.md`
- EXAMPLES:
  - "/registry search browser"
  - "/registry search QA"