Vibery Manager

Unified workflow for managing the Vibery monorepo.

Available Commands

Command	Description
`/template create <type> <name>`	Create new template (agent, command, skill, etc.)
`/template list [--type TYPE]`	List all templates
`/template pull <source>`	Pull from git repo or local path
`/kit create <name>`	Create new kit scaffold
`/kit add <kit> <item>`	Add template/skill to kit
`/kit remove <kit> <item>`	Remove item from kit
`/kit list [kit-name]`	List kits or kit contents
`/sync`	Sync templates + generate manifest
`/publish`	Push to GitHub (templates repo)
`/deploy`	Alias for `/sync` + `/publish` (one command)

Architecture

vibery-studio/templates (GitHub)     ← Single source of truth
├── agents/*.md
├── commands/*.md
├── skills/*/
├── mcps/*.json
├── hooks/*.json
├── settings/*.json
├── registry.json                    ← Template catalog
└── templates-manifest.json          ← File listing (no API needed)

vibe-templates/ (local)
├── templates/                       ← Maps to vibery-studio/templates
├── cli/                             ← npm package "vibery"
├── stacks/                          ← Kits
└── website/                         ← kits.vibery.app

How CLI Fetches Templates (No Rate Limits)

CLI fetches templates-manifest.json via raw GitHub URL
Manifest lists all files per template type
CLI downloads files via raw URLs (no GitHub API = no rate limits)
Fallback to bundled templates if network fails

Key: Raw GitHub URLs (raw.githubusercontent.com) have NO rate limits.

Deployment Flow

Add new template (no CLI publish needed):

# 1. Create template
/template create agent my-new-agent

# 2. Sync + generate manifest
/sync

# 3. Push to GitHub
/publish

# Done! npx vibery install my-new-agent works immediately

What /sync does:

Runs node scripts/sync-all.js (registry + website data)
Runs node cli/scripts/generate-templates-manifest.js (manifest)
Copies manifest to templates/

What /publish does:

cd templates && git add . && git commit && git push

CLI auto-fetches from GitHub raw URLs (no npm publish needed for template updates).

Quick Workflow

Create Template

/template create agent security-auditor
# Or manually:
echo "---
name: my-agent
description: What it does
---
# Content" > templates/agents/my-agent.md

Create Kit

/kit create backend-stack
/kit add backend-stack databases
/kit add backend-stack api-security

Deploy Everything

/deploy         # One command: sync + push to GitHub + deploy website

Script Locations

Script	Purpose
`scripts/sync-all.js`	Templates → CLI + website
`cli/scripts/generate-templates-manifest.js`	Generate templates-manifest.json
`.claude/skills/vibery-manager/scripts/manage.py`	Kit management + kit sync
`.claude/skills/vibery-manager/scripts/validate-kits.py`	Validate kit structures

Deployment Targets

Target	URL/Package	Update Method
GitHub	vibery-studio/templates	`/publish` → git push
CLI	`npx vibery`	Auto-fetches from GitHub
Website	https://kits.vibery.app	Separate deploy if needed

Note: CLI npm package only needs update for CODE changes, not template updates.

Generated Files

Source	Output	Used By
`templates/*`	`templates/templates-manifest.json`	CLI (remote fetch)
`templates/*`	`templates/registry.json`	CLI (template list)
`templates/*`	`website/src/data/templates.json`	Website
`stacks/*`	`website/src/data/kits.json`	Website
`stacks/*`	`cli/kits.json`	CLI

Workflow Examples (Multi-Context Prompts)

Example 1: Create New Kit

Context 1 - Plan:

I want to create a "devops-essentials" kit with Docker, CI/CD, and monitoring templates.
What agents and skills should I include?
``

...

vibery-manager

SKILL.md