Custom Modes for Roo Code plugin
A library of 225 ready-made Roo Code modes for developer, DevOps, security and other roles, stored as YAML files.
- 184 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Modes change system instructions only, yet an agent with terminal and file access still runs commands.
Install
- Works in
Manual install
git clone https://github.com/jtgsystems/Custom-Modes-Roo-Code.gitThe first Quick Start command. Then copy the chosen category from `agents/` to `~/.roo-code/agents/`.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Modes change system instructions only, yet an agent with terminal and file access still runs commands.
This is third-party code. Review the repository files before installing.
What it does
The repository holds 225 YAML mode definitions for the Roo Code extension in VS Code. Each mode sets a role through `roleDefinition`, so the agent acts as a Python developer, an SRE, a GDPR specialist or another role. Modes sit in ten categories, and 11 SOTA personas cover reasoning-heavy work. The `convert_modes.py` script in `vs-code/` converts YAML into the format the extension reads. You can copy one category, all modes at once, or load a single YAML directly through the Roo Code custom modes system.
Who it is for. Roo Code users who want a ready set of roles instead of writing every mode by hand.
Good fit when
- A team adds modes for its stack to Roo Code: FastAPI, React or Kubernetes.
- A developer takes one category, such as `core-development`, and copies it to `~/.roo-code/agents/`.
- A mode author looks for a YAML sample with the `slug`, `name` and `roleDefinition` fields.
- A task runs through a chain of reasoning roles, handing results between SOTA personas.
Not a fit when
- The agent runs in Claude Code or Cursor, while the files target the Roo Code format.
- Legal and financial roles are expected to replace a specialist consultation.
- One role is enough, and 225 modes are overkill for a one-off task.
Example request
Switch to the `python-developer` mode and review a FastAPI module: types, error handling, tests.Limitations
The modes are written for Roo Code and move to other agents by hand. The README pins the stack to 2026 (React 19+, Node.js 22+, Python 3.13+), so versions in the instructions age with the ecosystem. Conversion and AI modes need Python 3.13+ and Node.js 22+ according to the README. Legal roles (Canadian and US law, GDPR) shape tone and structure but do not replace a lawyer. Modes exist in several formats at once (`.roomodes`, `custom_modes.d/`, `vs-code/converted_modes.d/`), so it is easy to pick a stale copy. The last commit is from September 3, 2026.
How to disable. Delete the copied YAML from `~/.roo-code/agents/` and the modes from Roo Code settings. The cloned folder can be removed like any directory.
FAQ
How do I install only some modes?
Copy the folder you need, for example `cp agents/core-development ~/.roo-code/agents/ -r`. Copy SOTA personas the same way from `agents/sota-personas`.
What do I run for the VS Code format?
Run `python3 convert_modes.py` inside `vs-code/`. The README lists the Roo Code extension, Git, Node.js 22+ and Python 3.13+ as prerequisites.
Does the set work for Claude Code?
No, the README covers Roo Code only. The `roleDefinition` texts can be ported by hand, and there is no ready conversion for Claude Code.
Which mode categories exist?
Ten categories, including AI and machine learning, business, core development, infrastructure, languages, legal and compliance, orchestration and security. Eleven SOTA personas sit separately.
Can I edit modes for my own needs?
Yes. Each mode is a separate YAML file, so the `slug`, `name` and `roleDefinition` fields can be changed in place.
Discussion
No questions or reviews yet.
Related
PluginsA Grid Dynamics plugin that loads a team's shared engineering standards, architecture and workflows into a coding agent session
A 33-skill plugin with gates: question the request, verify facts against sources, test first, review by a second model
The claude-mode CLI launches Claude Code with a swapped behavioral prompt layer: presets from cautious safe to bold create
A Claude Code plugin: 39 commands for PRs, review, commits and specs, nine expert roles and hooks, in eight language versions
A set of Claude Code mods: status lines above the prompt, a guard against risky commands and a few small games
AI Code Toolkit
aicode-toolkit
Plugins and MCP servers for coding agents: template-based projects, patterns before a file edit and review against YAML rules.
README in short
The README describes three installation paths: a full clone, selective copying of categories and direct YAML use. Each category lists its roles and agent count.