Skip to content
Development
Skill

/agent-debate

Use when a consequential decision has two plausible, materially different options and you are about to pick one. Runs two opposed reviewers on the same evidence with a stated round cap, then hands the human a synthesis that names the deciding evidence.

From plugin
agent-collab-workspace
347 skills

Claude Code

$ npx -y skills add WenyuChiou/agent-collab-skills --skill agent-debate --agent claude-code

SKILL.md

agent-debate.SKILL.md
name: agent-debate
description: Use when a consequential decision has two plausible, materially different options and you are about to pick one. Runs two opposed reviewers on the same evidence with a stated round cap, then hands the human a synthesis that names the deciding evidence.

agent-debate

A bounded adversarial review of one consequential trade-off. Debate makes the evidence visible to the decision maker; it does not settle truth by vote and does not authorize implementation.

Use only when

  • both options are plausible and materially different;
  • the decision is consequential enough to justify two independent reviewers;
  • identifiable evidence could inform or falsify each side.

Do not debate a factual question that a direct check can settle, a naming preference, or a decision an authorized human already made.

Setup

1. Write one evidence packet: the decision and who owns it, the two positions as testable statements, shared evidence paths, and the criteria for judging. Template: [references/debate_protocol.md](references/debate_protocol.md). 2. Launch two `reviewer` lanes in parallel, one position each, both on a strong model tier, both read-only, both with the same packet. Each argues the strongest form of its side and cites evidence. 3. State the round cap before launch and stop there. A rebuttal round, if the cap allows one, answers the other side's strongest point. In harness mode the policy's `max_cycles` limit sets the cap; evaluate the policy before each reviewer spawn. 4. A reviewer that changes its conclusion says so plainly; do not simulate disagreement.

Synthesis

The primary-agent, or a separate `synthesizer` with no search tools, writes:

  • agreed facts, with evidence;
  • contested claims, with the evidence on each side;
  • missing or failed reviewer outputs (recorded, never invented);
  • a recommendation, how uncertain it is, and what finding would change it;
  • the pending human decision: approve, decline, or revise.

Nothing is implemented and no canonical memory changes until the human decides. If the outcome is worth keeping, write a memory proposal as described in `agent-context-budget`.

Prohibitions

  • No majority vote as evidence or acceptance.
  • No silent retry, model switch, context discard, or invented missing side.
  • No source edits, commits, merges, or pushes during the debate.
  • No direct write to canonical memory.
Read more
@wenyuchiou
Ships withagent-collab-workspace

繁體中文 · Public harness contract · Native lanes · 0.6 migration · 0.5 goal-slice migration · 0.4 migration Provider-neutral collaboration skills plus an optional, standard-library-first Python harness for bounded, resumable, human-authorized agent work.

Stars on GitHub

Momentum

stars in total
34
Star history of WenyuChiou/agent-collab-skills on GitHub, a chart by star-history.com

Other skills on agent-collab-workspace.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about agent-debate.

Which coding agents can use agent-debate?
agent-debate installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.