Roo Commander v9.0.0
Bridge your Claude Code skills to Roo Code with intelligent orchestration
Roo Commander is a three-component system that brings Claude Code's 60+ production-tested skills to Roo Code VS Code extension through a CLI tool, custom instructions, and an orchestrator mode.
🎯 What It Does
Roo Commander makes your Roo Code AI agent skill-aware:
- Automatic Skill Discovery - Before implementing features, checks if relevant skills exist
- CLI Integration - List, search, and load skills directly from Roo Code
- Orchestrator Mode - Lightweight mode that delegates to Code/Architect/Debug with skill context
- Session Management - Track progress through phases with /wrap-session and /continue-session
- Project Planning - Generate IMPLEMENTATION_PHASES.md with /plan-project
Why? Skills contain production-tested patterns, known issue prevention, and token-efficient documentation. Using skills saves 60-87% tokens vs web search + trial-and-error.
🚀 Quick Start
1. Install CLI
npm install -g roocommander
2. Install Roo Commander Mode
Global Installation (Recommended)
roocommander init
This installs Roo Commander globally - available in ALL your projects:
- Writes to
~/.config/Code/.../custom_modes.yaml
- Copies rules to
~/.roo/rules-roo-commander/
- 👑 Crown emoji indicates the mode
Project-Scoped Installation (Optional)
cd your-project
roocommander init --project
This installs only in the current project:
.roo/rules/ - Custom instructions (skills index, CLI usage, patterns)
.roo/rules-roo-commander/ - Mode-specific rules
.roo/commands/ - 9 slash commands
.roomodes - Roo Commander mode entry
⚠️ Important: After running roocommander init, reload VS Code (Command Palette → "Developer: Reload Window") to see 👑 Roo Commander in the mode selector.
3. Use Roo Commander
In Roo Code:
/mode roo-commander
"I want to build a chat interface with OpenAI and save conversations to D1"
// Roo Commander will:
// 1. Check skills index for "chat", "openai", "d1"
// 2. Find: ai-sdk-ui, openai-api, cloudflare-d1
// 3. Delegate to Code mode with skill loading instructions
📦 What's Included
CLI Commands
roocommander list
roocommander search ai
roocommander read "skill-name"
roocommander generate-index
roocommander init
Slash Commands (9 total)
Session Management:
/wrap-session - Save progress, create git checkpoint
/continue-session - Resume from SESSION.md
/list-skills - Browse available skills
/load-skill <name> - Load specific skill
Planning:
/explore-idea - Research and validate project idea
/plan-project - Create IMPLEMENTATION_PHASES.md
/plan-feature - Add feature to existing project
Release:
/github-release <version> - Create GitHub release
/release <version> - Complete release checklist
Roo Commander Mode
Lightweight orchestrator that:
- Analyzes user requests
- Checks
.roo/rules/01-skills-index.md for relevant skills
- Delegates to Code/Architect/Debug modes with skill instructions
- Tracks completion
When to use:
- Starting new features (auto skill discovery)
- Complex multi-step workflows
- Unsure which skill to use
When to bypass:
- Simple edits (use Code mode directly)
- Already know which skill (load it manually)
💡 Example Workflows
Workflow 1: New Cloudflare Workers Project
/mode roo-commander
"Set up a new Cloudflare Workers project with D1 database and Tailwind v4"
// Roo Commander response:
Found 3 relevant skills:
• cloudflare-worker-base: Project scaffolding
• cloudflare-d1: Database setup
• Tailwind v4 + shadcn/ui Stack: Frontend styling
Delegating to Code mode with instructions to load these skills...
[Code mode receives message]:
Task: Scaffold Cloudflare Workers project with D1 and Tailwind v4
Skills to use:
- Run: `roocommander read "cloudflare-worker-base"`
- Run: `roocommander read "Cloudflare D1 Database"`
- Run: `roocommander read "Tailwind v4 + shadcn/ui Stack"`
[Implementation follows skill patterns]
Workflow 2: Adding Authentication
/mode code // Already in Code mode
// Load skill before implementing
/load-skill clerk-auth
"Add Clerk authentication with session storage in D1"
[Code mode uses skill patterns to implement correctly]
Workflow 3: Project Planning
/plan-project
// Guided workflow:
Project name: Task Manager
Tech stack: React, Cloudflare Workers, D1
Features: User auth, task CRUD, filtering
// Creates:
• docs/IMPLEMENTATION_PHASES.md (8 phases, 20-24 hours)
• SESSION.md (session tracking)
// Start Phase 1
[Load relevant skills and begin implementation]
🏗️ Architecture
Three-Component System:
┌─────────────────────────────────────────────────────┐
│ 1. CLI Tool (roocommander) │
│ - List/search/read skills │
│ - Generate skills index │
│ - Initialize project │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ 2. Custom Instructions (.roo/rules/) │
│ - 01-skills-index.md (categorized skills) │
│ - 02-cli-usage.md (CLI command reference) │
│ - 03-skill-patterns.md (when to check skills) │
│ - 9 slash commands (.roo/commands/) │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ 3. Roo Commander Mode (.roomodes entry) │
│ - Orchestrates skill discovery │
│ - Delegates to Code/Architect/Debug │
│ - Workflow tools only (no file access) │
└─────────────────────────────────────────────────────┘
See docs/ARCHITECTURE.md for complete system design and data flow diagrams.
📚 Documentation
🎨 Skills Available
60+ Production-Tested Skills organized by category:
🤖 AI & LLM Integration (29 skills)
OpenAI, Claude, Gemini, Vercel AI SDK, ElevenLabs agents, chatbots
☁️ Cloudflare Platform (15 skills)
Workers, D1, R2, KV, Durable Objects, Workflows, AI, Vectorize, Queues
⚛️ Frontend Stack (11 skills)
React, Next.js, Tailwind v4, shadcn/ui, TanStack Query/Router/Table, Zustand
🔐 Authentication (3 skills)
Clerk, Better Auth, Auth.js
📝 Forms & Validation (2 skills)
React Hook Form + Zod patterns
📊 Data & Scraping (3 skills)
Drizzle ORM, Firecrawl, WordPress plugins
📄 Content Management (3 skills)
TinaCMS, Sveltia CMS, Content Collections
📋 Project Planning (1 skill)
IMPLEMENTATION_PHASES.md generation
See .roo/rules/01-skills-index.md for complete list with descriptions and keywords.
🔧 CLI Reference
list
Show all available skills.
roocommander list
roocommander list --verbose
roocommander list --source ~/custom/skills
Output: Table of skill names, descriptions, keywords
search
Find skills by keyword.
roocommander search database
roocommander search cloudflare
roocommander search auth --verbose
Scoring: Name match > keyword match > description match
read
Output skill content.
roocommander read "Cloudflare D1 Database"
roocommander read clerk-auth --raw
Fuzzy matching: "cloudflare d1" matches "Cloudflare D1 Database"
generate-index
Create categorized skills index.
roocommander generate-index
roocommander generate-index --output custom/path.md
Output: .roo/rules/01-skills-index.md with 7 categories
init
Initialize Roo Commander in project.
roocommander init
roocommander init --force
roocommander init --source ~/custom/skills
Creates: Complete .roo/ structure, skills index, .roomodes entry
See docs/CLI_REFERENCE.md for complete documentation.
🧪 Testing
Manual Testing Checklist
CLI Commands:
Slash Commands (in Roo Code):
Roo Commander Mode:
🛠️ Development
Setup
git clone https://github.com/jezweb/roo-commander.git
cd roo-commander
npm install
npm run build
npm link
Project Structure
roo-commander/
├── src/
│ ├── commands/ # CLI command handlers
│ │ ├── list.ts
│ │ ├── read.ts
│ │ ├── search.ts
│ │ ├── generate-index.ts
│ │ ├── sync-index.ts
│ │ └── init.ts
│ ├── parser/ # Skill YAML parsing
│ │ └── skill-parser.ts
│ ├── generator/ # Index generation
│ │ └── index-generator.ts
│ ├── installer/ # Template installation
│ │ ├── github-cloner.ts
│ │ └── template-installer.ts
│ ├── templates/ # Template files
│ │ ├── .roomodes-entry.yaml
│ │ ├── rules/ # 02-cli-usage.md, 03-skill-patterns.md
│ │ ├── rules-roo-commander/ # Mode rules (3 files)
│ │ └── commands/ # Slash commands (9 files)
│ ├── types.ts # TypeScript types
│ ├── cli.ts # CLI entry point
│ └── index.ts # Package entry
├── docs/ # Documentation
├── package.json
└── tsconfig.json
📝 License
MIT © 2025 Jeremy Dawes / Jezweb
🤝 Contributing
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Make changes
- Add tests if applicable
- Submit PR with description
🔗 Links
📞 Support
🎉 Acknowledgments
- Anthropic - Claude Code and skills ecosystem
- Roo Code Team - VS Code extension
- Jezweb Skills - 60+ production-tested skills
Version: 9.2.0 (Workflow orchestration awareness - proactive lifecycle guidance)
Last Updated: 2025-11-13