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"