Zuvo
Auto-activating, multi-agent skill ecosystem for Claude Code, Codex, Cursor, and Antigravity.
57 skills, 50 sub-agent definitions (48 distinct roles), quality gates, knowledge store, session recovery, and structured workflows — all in one plugin.
Install
Quick install (all platforms)
curl -fsSL https://raw.githubusercontent.com/greglas75/zuvo/main/scripts/quick-install.sh | bash
Installs to Claude Code + Codex + Cursor + Antigravity in one command. Restart your IDE after install.
Claude Code (recommended)
Requires Claude Code 1.0.33+. Check with
claude --version, update withclaude update.
# Add the Zuvo marketplace (one-time)
claude plugin marketplace add greglas75/zuvo-marketplace
# Install
claude plugin install zuvo
Codex
git clone https://github.com/greglas75/zuvo.git
cd zuvo
./scripts/install.sh codex
Cursor
git clone https://github.com/greglas75/zuvo.git
cd zuvo
./scripts/install.sh cursor
Antigravity
git clone https://github.com/greglas75/zuvo.git
cd zuvo
./scripts/install.sh antigravity
All platforms (for plugin developers)
./scripts/install.sh
Update
Claude Code
claude plugin marketplace update zuvo-marketplace
claude plugin update zuvo@zuvo-marketplace
Or enable auto-updates:
/plugin → Select zuvo-marketplace → Enable auto-update
If skills don't appear after update (known Claude Code cache issue):
claude plugin uninstall zuvo@zuvo-marketplace
claude plugin install zuvo
Then start a new session.
Codex / Cursor / Antigravity
cd /path/to/zuvo
git pull
./scripts/install.sh codex # or: cursor, antigravity, all
What install.sh does
One script, four platforms:
| Platform | What it does |
|---|---|
| Claude Code | Copies source files to plugin cache (~/.claude/plugins/cache/...) |
| Codex | Builds adapted distribution (path replacement, unicode normalization, TOML agent generation) then copies to ~/.codex/skills/ + ~/.codex/agents/ |
| Cursor | Builds adapted distribution (Cursor v3 agent frontmatter, flat agents with skill prefixes) then copies to ~/.cursor/skills/ + ~/.cursor/agents/ |
| Antigravity | Builds adapted distribution (build-antigravity-skills.sh) then copies to ~/.gemini/antigravity/skills/ + ~/.gemini/antigravity/shared/ |
./scripts/install.sh # all platforms (default)
./scripts/install.sh claude # Claude Code only
./scripts/install.sh codex # Codex only
./scripts/install.sh cursor # Cursor only
./scripts/install.sh antigravity # Antigravity only
Local development
For testing changes without committing:
# Edit files in zuvo-plugin/, then:
./scripts/install.sh
# Restart Claude Code / Codex to pick up changes
Optional: add CodeSift MCP for deep code analysis:
# ~/.codex/config.toml
[mcp_servers.codesift]
command = "npx"
args = ["-y", "codesift-mcp"]
What's inside
- Pipeline skills —
zuvo:brainstorm→zuvo:plan→zuvo:executewith multi-agent exploration, quality gates, and evidence-based review - 52 non-pipeline skills (5 pipeline + 52 = 57) — build, review, refactor, debug, 17 audits, write-article, content-expand, design, docs, ship, deploy, canary, retro, incident, mutation-test, benchmark, and more
- Release pipeline —
zuvo:ship→zuvo:deploy→zuvo:canaryfor the full post-code lifecycle - Knowledge Store — JSONL-based project memory. Skills learn from past sessions (patterns, gotchas, decisions). Auto-primed at session start and per-skill
- Session Recovery — execution state persisted to
.zuvo/context/. Resume after context compaction or crashes without losing progress - Adversarial review — 5-provider cross-model verification with evidence enforcement (findings without file:line auto-downgraded)
- Auto-activation — routing engine matches your intent to the right skill automatically
- CodeSift integration — semantic search, community detection, call chain tracing, complexity analysis
- Quality gates — CQ1-CQ40 (code quality) and Q1-Q25 (test quality) with unified severity vocabulary
Platform support
| Platform | Status | Install |
|---|---|---|
| Claude Code | Stable | claude plugin install zuvo |
| Codex | Experimental | ./scripts/install.sh codex |
| Cursor | Stable (v3 sub-agents) | ./scripts/install.sh cursor |
Skills
| Category | Count | Skills |
|---|---|---|
| Pipeline | 5 | brainstorm, plan, execute, worktree, receive-review |
| Core | 4 | build, review, refactor, debug |
| Code/Test audits | 5 | code-audit, test-audit, api-audit, security-audit, pentest |
| Infra audits | 7 | performance-audit, db-audit, dependency-audit, ci-audit, env-audit, infra-audit, container-audit |
| Structure/SEO/GEO | 6 | structure-audit, seo-audit, seo-fix, geo-audit, geo-fix, architecture |
| Content | 5 | content-audit, content-fix, content-migration, write-article, content-expand |
| Design | 3 | design, design-review, ui-design-team |
| Testing | 5 | write-tests, fix-tests, write-e2e, tests-performance, mutation-test |
| Accessibility | 1 | a11y-audit |
| Release | 5 | ship, deploy, canary, release-docs, retro |
| Utility | 10 | docs, presentation, backlog, incident, benchmark, agent-benchmark, using-zuvo, context-audit, skill-eval, profile-session |
| Lead Generation | 1 | leads |
Documentation
- All 57 Skills
- Pipeline — brainstorm → plan → execute
- Quality Gates — CQ1-CQ40 + Q1-Q25 + CAP1-CAP29 + AP1-AP32
- CodeSift Integration
- Adversarial Review Providers — which models cross-check the work, and how to authenticate them
- Retro Learning Loop — how zuvo mines its own runs for improvements
- Configuration
- Changelog
For maintainers
Release to marketplace (for end users)
./scripts/release.sh patch "fix: description"
./scripts/release.sh minor "feat: description"
This bumps version, commits, pushes, tags, updates marketplace SHA.
Install locally (for development)
./scripts/install.sh
This syncs source to Claude Code cache + Codex + Cursor. No git push, no marketplace update.
What package.json is for
Metadata only (name, version, description). There are no npm dependencies. No npm install needed. The version field is read by release.sh and install.sh.
License
MIT
