About revolver
revolver is a review skill that tests a target against distinct risk-focused viewpoints, using a fresh reviewer for each stance. It verifies findings against evidence and cycles through the pool until a quiet rotation or three cycles.
Key features
- 01Derive distinct stances from risks and context
- 02Order reviews by consequence and uncertainty
- 03Dispatch a fresh reviewer per stance
- 04Verify findings against direct evidence
- 05Repeat rotations until defined stop conditions
Use cases
- 01Review changes across trust boundaries and data flows
- 02Test security or correctness claims from separate viewpoints
- 03Resolve or escalate findings before continuing a review
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ jcosta33/ skills --skill revolverAfter installing, type/revolverin Claude Code to confirm it loaded.
Details
From the project READMERevolver
Every justified angle. Every finding dead before the next.
Method
- Freeze the target state.
- Derive the complete materially distinct stance pool from requirements, trust boundaries, data and control flow, changed surfaces, failure modes, users, and operating conditions. Cover every exposed material risk. Reject duplicates and filler. Honor explicit human constraints; otherwise choose the pool without asking. Use no fixed floor or ceiling.
- Give each stance one falsification question and target evidence. Order the pool by consequence and uncertainty. Freeze it for the rotation.
- Dispatch one fresh reviewer at a time on the cheapest adequate model. Give it the current target, one stance, and no prior reviewer prose. If fresh dispatch is unavailable, stop. Self-review is not fresh.
- Fact-check every finding against direct evidence. Kill every finding before the next stance:
- supported: apply the fix and verify it when settled authority determines the fix; otherwise stop as a human decision;
- refuted: reject it with decisive evidence;
- human decision: force material ambiguity into explicit human selection; stop until selected;
- unverified or blocked: name the missing evidence or capability and stop.
- Freeze the addressed target for the next stance.
- Finish the full pool. After a productive rotation, rebuild the pool against the current target. Add or remove stances only between rotations.
- Stop after one quiet rotation or three cycles.
One cycle is one full pool rotation. Productive means a supported finding was fixed and verified. Quiet means no actionable finding survived verification.
Output
Return material fixes and verification, consequential refutations, and unresolved human decisions. For each decisive run, include command, working directory, state identifier, numeric exit, and the smallest untouched decisive output excerpt once.
Boundaries
Reviewers attack claims, callers, and companion surfaces. They return only actionable findings: location, consequence, evidence, minimal fix. The orchestrator fixes; reviewers stay independent.