Council

Agent Council

Convene a multi-agent council to deliberate on a question. You (Claude) are the chairman. Other CLI agents (Codex, Gemini) provide independent opinions. You synthesize the final verdict.

Usage

The user invokes /council "their question" or /council --with-review "their question".

Step 1: Dispatch the council

Run this bash block. Replace {QUESTION} with the user's actual question text.

COUNCIL_BIN=""; for _d in "$HOME/.claude/skills/agent-council" "$HOME/.agents/skills/agent-council" "$HOME/.gemini/skills/agent-council" "$(git rev-parse --show-toplevel 2>/dev/null)"; do [ -x "$_d/bin/council" ] && COUNCIL_BIN="$_d/bin/council" && break; [ -x "$_d/council" ] && COUNCIL_BIN="$_d/council" && break; done; [ -z "$COUNCIL_BIN" ] && COUNCIL_BIN="$(which council 2>/dev/null || echo "bin/council")"
QUESTION_FILE=$(mktemp /tmp/council-q-XXXXXX)
cat  "$QUESTION_FILE"
{QUESTION}
COUNCIL_EOF
SLUG=$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")
SESSION_DIR=$($COUNCIL_BIN --question-file "$QUESTION_FILE" --project "$SLUG")
rm -f "$QUESTION_FILE"
echo "SESSION_DIR=$SESSION_DIR"

If the user passed --with-review, add that flag to the council command. If the user passed --quick, add that flag instead.

Step 2: Read the council opinions

After the bash block completes, read the opinion files from the session directory:

1. Read $SESSION_DIR/meta.json to understand the session structure
2. Read each file in $SESSION_DIR/stage1/ (opinioncodex.json, opiniongemini.json, etc.)
3. If --with-review was used, also read files in $SESSION_DIR/stage2/

Step 3: Synthesize as chairman

You are the chairman. You have the full conversation context with the user PLUS the council opinions. Produce the synthesis:

• Consensus: Where all agents agree
• Divergence: Where agents disagree. State each position fairly with agent name.
• Recommendation: Your synthesized answer drawing from the strongest elements.
• Confidence:
• If all agree: HIGH — Strong consensus across models.
• If majority agrees: MEDIUM — Majority view with notable dissent.
• If fundamental disagreement: LOW — Agents fundamentally disagree.

For each agent, state: Agent name (their confidence): their position. End with: "This is a decision you should make yourself, not delegate to the council."

Step 4: Save synthesis

Write your synthesis to $SESSION_DIR/synthesis.json:

{
  "chairman": "claude",
  "consensus": "...",
  "divergence": "...",
  "recommendation": "...",
  "confidence": "high|medium|low",
  "timestamp": "ISO 8601"
}

Step 5: Regenerate the viewer

After writing synthesis.json, regenerate the viewer so it includes your verdict:

$COUNCIL_BIN regenerate-viewer "$(basename "$SESSION_DIR")" --project "$SLUG"

Step 6: Offer the viewer and next steps

Tell the user:

> Council viewer saved to: $SESSION_DIR/viewer.html — open in browser to explore the full deliberation. > > Next steps: > - Re-evaluate later with current context: /council-revisit {SESSION_ID} > - Record how this decision played out: /council-outcome {SESSION_ID} "what happened" > - Browse past sessions: /council-list

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: yogirk
• Source: yogirk/agent-council
• License: MIT

Install and usage instructions live in the source repository linked above.