# llm-council

This skill runs several CLI agents as independent planners, strips their identities, and merges the results into one final plan. Useful when a single model's bias is the problem.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 1039
- Author: am-will
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/am-will/codex-skills/tree/HEAD/skills/llm-council/SKILL.md
- Updated: 2026-07-14
- HTML: https://affpapa.org/en/nevibecode/skills/am-will-llm-council

## What it does

The skill spins up a council of planners: Codex, Claude, Gemini, OpenCode, or your own command. Each agent gets the same brief and writes a plan without seeing the others. Then the plans are anonymized, shuffled, and handed to a judge, so neither model name nor position sways the verdict.

You run it with `python3 scripts/llm_council.py run --spec /path/to/spec.json`. The lineup lives in `agents.planners`, and `agents.judge` overrides the judge; leave it out and the first planner takes that seat. Defaults are written by `python3 scripts/llm_council.py configure` to `$XDG_CONFIG_HOME/llm-council/agents.json` or `~/.config/llm-council/agents.json`. Plans land as Markdown, run artifacts under `./llm-council/runs/<timestamp>`.

Check the agents config before the first run: with no file present, the skill tells you to run `./setup.sh`. Python 3 is required. Do not close the session while the council works — yielding before the 30-minute mark and before `judge.md` and `final-plan.md` are saved kills the run. Answering the intake questions is optional, but the skill notes that more detail improves the final plan.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill llm-council -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/llm-council/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/llm-council/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill llm-council -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/llm-council/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill llm-council -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/llm-council/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install am-will/codex-skills llm-council
```

2. **Manually: put the files in place**
- File: `.github/skills/llm-council/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill llm-council -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/am-will/codex-skills --path skills/llm-council
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/llm-council/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill llm-council -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/am-will/codex-skills/tree/HEAD/skills/llm-council/SKILL.md

## When to use it
- get independent plans from several CLI agents for one task
- remove one-model bias when picking an approach
- merge competing plans into a single document with a judge's reasoning
- survive a planner failure through retries
- keep a run on disk for later review

## Example prompts
- run llm-council on this task and assemble the planner council
- configure a council of Codex, Claude and OpenCode, then run it
- run llm-council and save the final plan under llm-council/runs

## Similar
- [council](https://affpapa.org/en/nevibecode/skills/boshu2-council.md) — skill · 3000 installs
- [llm-context](https://affpapa.org/en/nevibecode/skills/llm-context.md) — skill · 1300 installs
- [jetson-llm-serve](https://affpapa.org/en/nevibecode/skills/jetson-llm-serve.md) — skill · 1200 installs
- [quark-torch-llm-ptq](https://affpapa.org/en/nevibecode/skills/quark-torch-llm-ptq.md) — skill · 524 installs
- [auto-review-loop-llm](https://affpapa.org/en/nevibecode/skills/auto-review-loop-llm.md) — skill · 496 installs
- [llm-eval-harness](https://affpapa.org/en/nevibecode/skills/llm-eval-harness.md) — skill · 372 installs

## Other versions with the same name
- [llm-council · aiwithremy](https://affpapa.org/en/nevibecode/skills/llm-council.md) — 1400 installs

From the same set: [am-will/codex-skills](https://affpapa.org/en/nevibecode/by/am-will/codex-skills.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
