cmux-review — Claude Code skill: what it does, how to install
Runs an independent subagent review on agent-generated diffs before merge. Focuses on code correctness while filtering out stylistic nits.
npx skills add manaflow-ai/cmux --skill cmux-review -a claude-codeWhat cmux-review does
The skill hands the goal, commit identifiers, and diff to a subagent within the current runtime. It evaluates functional correctness first. Minor formatting quibbles and unprompted style suggestions are silenced to avoid wasting developer attention. Policy changes are checked against the base branch.
Verification requires strict evidence. A passing test only counts if it actively reproduces the failure beforehand, enforcing a red-before and green-after pattern. Scratch reproduction scripts and generated test receipts must not be committed to Git. The process stays strictly read-only until repairs are authorized.
High-risk tasks involving security or concurrency trigger an adversarial protocol. This mode demands executable checks and counterevidence before merging. The main branch strategy is direct. Changes stack forward in main without reverting.
What it helps with
- catch logic defects in agent-written diffs before merge
- suppress subjective comments about formatting and code style
- verify bug fixes with red-before and green-after tests
- audit security and concurrency risks under an adversarial protocol
Example prompts for the agent
- Run a pre-merge review on the latest commit diff
- Execute an adversarial review on the concurrency changes in storage
- Verify this bug fix with an independent subagent
How to install cmux-review
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-review -a claude-code2Manually: put the files in place
~/.claude/skills/cmux-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cmux-review/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-review -a codex2Manually: put the files in place
.agents/skills/cmux-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-review -a cursor2Manually: put the files in place
.cursor/skills/cmux-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install manaflow-ai/cmux cmux-review2Manually: put the files in place
.github/skills/cmux-review/SKILL.md1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-reviewManually: put the files in place
.devin/skills/cmux-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-review -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cmux-review
How to install cmux-review in Claude Code?
Run npx skills add manaflow-ai/cmux --skill cmux-review -a claude-code in your terminal.
What does cmux-review do?
It spins up a subagent to inspect code diffs for functional bugs and repository rule violations. The review ignores style issues unless specifically requested.
When should the adversarial review protocol be used?
Use it for high-risk changes involving security, persistence, concurrency, or potential data loss. It requires counterevidence, executable verification, and persisted audit reports.
