🚀 Zen Agent Skills: The Cursor AI OS

Turn Cursor into a Collaborative, Evolving Senior Engineering Team.

zen-agent-skills is more than just a collection of rules—it's a complete operating system mod for Cursor. It transforms your AI from a simple assistant into a team of specialized, hierarchical agents that coordinate complex tasks, learn from your project, and grow more capable over time.

---

✨ What This Package Does

This package gives you a production-grade AI infrastructure:

* 🔄 Multi-Agent Orchestration: Coordinate multiple agents (/architect, /security, /reviewer) to work together on complex workflows with automatic context sharing.
* 🎯 Sub-Sub-Agent System: Hierarchical specialization for deep expertise (e.g., /reviewer:performance, /architect:database).
* 🧠 Learning & Memory: A persistent "brain" that remembers successful patterns, project-specific preferences, and grows with every session.
* 🗺️ Codebase Intelligence: Automatically builds a knowledge graph of your entire codebase structure, dependencies, and patterns.
* 🚀 Vercel Performance Pack: 49+ rules from Vercel Engineering to eliminate waterfalls and optimize React/Next.js apps.
* ⚡ Always-On Guidance: 55+ Cursor Rules that automatically enforce best practices while you code.

---

🧠 Core Components of the AI OS

$3

Coordinate specialized experts through structured workflows.
``bash

Complex task - orchestrator coordinates multiple agents

"Build a payment feature with authentication, database, and API"

Orchestrator automatically plans and executes:

/architect → /security → /reviewer → /test-runner → /verifier

`

$3

Summon specialized experts within any domain for deeper analysis.
* /reviewer:performance — Deep React/Next.js optimization audit.
* /reviewer:security — Rigorous security vulnerability scan.
* /architect:database — Data modeling and schema optimization.
* /architect:api — REST/GraphQL interface design.

$3

Your agents get smarter the more you use them.
* Usage Learning: Agents remember patterns you accept and avoid those you reject.
* Experience Tracking: Agents track their "success rate" and develop project-specific expertise.
* Growth Path: Agents evolve from generic assistants to specialized project experts.

---

🛠 Usage & Commands

Once installed, your agents and rules use the built-in zen-agent-skills os engine to power their intelligence.

$3


`bash
/orchestrator Plan a feature development workflow for "User Dashboard"
`

$3

`bash
/reviewer:performance Analyze this component for re-render bottlenecks
`

$3

`bash

Agents run these automatically behind the scenes:

npx zen-agent-skills os build-graph # Update codebase knowledge
npx zen-agent-skills os record-success "..." # Save a project-winning pattern
`

---

📦 Quick Installation

Transform your IDE in seconds. Run this in your project root:

$3

`bash
npx github:ZenderGoD/zen-agent-skills
`

Note: This package is currently hosted on GitHub. To use npx zen-agent-skills directly (without github:), publish to npm first:
`bash
npm login
npm publish
`

The installer will audit your project and let you select:
1. ✅ Subagents Pack (8 specialized agents)
2. ✅ Sub-Sub-Agents (Hierarchical specialization)
3. ✅ Multi-Agent Orchestrator (Workflow coordination)
4. ✅ Learning & Memory System (Persistent growth)
5. ✅ Codebase Intelligence (Deep structure mapping)
6. ✅ Performance Rules (49+ Vercel best practices)

---

🎓 How It Works

1. Installation: Files are copied to your project's .cursor/ directory.
2. Triggering: Rules (.mdc) trigger automatically based on file patterns (globs).
3. Specialization: Agents (.md) are invoked via /name syntax.
4. Collaboration: The Orchestrator uses YAML workflows to pass context between agents.
5. Persistence: All data (memory, graph, analytics) is stored locally in your project for privacy and project-specific learning.

---

🤝 Contributing

We welcome contributions to grow this ecosystem!
* Add new Sub-Sub-Agents
* Define new YAML Workflows
* Improve Performance Rules

---

📦 Publishing to npm

To make this package available via npx zen-agent-skills:

1. Login to npm:
`bash
npm login
`

2. Publish the package:
`bash
npm publish
`

3. Users can then install directly:
`bash
npx zen-agent-skills
`

Current Status: Package is hosted on GitHub. Use npx github:ZenderGoD/zen-agent-skills` for installation.

---

📝 License

MIT License - Use freely in your projects.

---

Made with ❤️ to turn your AI into a senior engineering partner.