council
Skill3 starsChanged 24 days agoMITView on GitHub
Convene a multi-voice AI council that deliberates on a hard decision through independent positions, a blind peer-review round, and a chairman synthesis. Use for ambiguous calls with several credible paths, such as architecture choices, build-vs-buy, ship-vs-hold, strategy tradeoffs, go/no-go calls, hiring or vendor decisions, and risk reviews, or whenever you want structured disagreement and second opinions before committing. Triggers include "council", "convene a council", "second opinions", "stress-test this decision", "get me dissent", and "multiple perspectives".
143 other projects use a version of this, 15 of them edited.
Adopted by
Most recently taken up by
- Beskars-Code/Skillstheir own version, first seen Nov 8, 2026
- Gabriel-Lafrance/Skillstheir own version, first seen Nov 8, 2026
- ong6/skillstheir own version, first seen Nov 8, 2026
- lbussell/agent-skillstheir own version, first seen Nov 8, 2026
- scottwater/skillstheir own version, first seen Nov 8, 2026
- T0mSIlver/skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use agent-payment-x402, motion-advanced and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
TironFoxSkillagent-payment-x402
Add x402 payment execution to AI agents — per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents need to pay for APIs, services, or other agents.
Also in 5 projects that use this
renepfSkillmotion-advanced
Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.
Also in 4 projects that use this
RojiosSkilldefi-amm-security
Security checklist for Solidity AMM contracts, liquidity pools, and swap flows. Covers reentrancy, CEI ordering, donation or inflation attacks, oracle manipulation, slippage, admin controls, and integer math.
Also in 6 projects that use this
scottwaterSkillmodernize
Rebase an aging PR onto its current base and decide whether it should be modernized, reworked, or closed. Use when asked to rebase, update, or modernize an old PR.
Also in 7 projects that use this
RojiosSkilldart-flutter-patterns
Production-ready Dart and Flutter patterns covering null safety, immutable state, async composition, widget architecture, popular state management frameworks (BLoC, Riverpod, Provider), GoRouter navigation, Dio networking, Freezed code generation, and clean architecture.
Also in 5 projects that use this
scottwaterSkillleaving-pr-comments
Format comments an agent posts on GitHub on the user's behalf. Use whenever leaving a PR comment, review comment, or reply.
Also in 6 projects that use this
- +1 more from scottwater
- +1 more from Rojios
Other versions143 projects use a version of this.
Word for word · 0
None found.
Edited · 15
- Fmarzochi/EGC★ 6124% same
- drvoss/everything-copilot-cli★ 4815% same
- gongyijie85/dsh-ecc★ 824% same
- VoVuongThanhDat/agentflow★ 824% same
- chadixearth/graphyloop★ 324% same
- hahuyhungdev/ai-coding-config★ 313% same
- divysharma-code/Skills★ 124% same
- NISTALTALSON/essential-claude-skills★ 124% same
- Rojios/everything-claude-code★ 124% same
- SamuelNDCE/claude-super-skill-library★ 124% same
5 more not listed
Wrote their own version · 128
- simstudioai/sim★ 30ksame name
- 0xNyk/council-of-high-intelligence★ 4.8ksame name
- t3dotgg/tstack★ 2.5ksame name
- danieleteti/delphimvcframework★ 1.4ksame name
- warpdotdev/common-skills★ 630same name
- QuixiAI/agi-memory★ 623same name
- QuixiAI/Hexis★ 623same name
- zaxbysauce/opencode-swarm★ 519same name
- ZaxbyHub/opencode-swarm★ 518same name
- boshu2/agentops★ 453same name
118 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository51 other files it gives its agents.
- guidelines/CLAUDE.mdCLAUDE.md
- animate-expoSkill
- animateSkill
- animation-vocabularySkill
- apple-designSkill
- ask-sonnerSkill
- batch-grill-meSkill
- bi-dashboardsSkill
- bouw-loopSkill
- brandkitSkill
- code-auditSkill
- commit-disciplineSkill
- createlooppromptSkill
- data-visualizationSkill
- design-taste-frontendSkill
- diagram-designSkill
- dicht-loopSkill
- e2e-rulesSkill
- e2eSkill
- emil-design-engSkill
- find-animation-opportunitiesSkill
- find-bugsSkill
- fixing-accessibilitySkill
- fix-loopSkill
- frontend-gotchasSkill
- goalSkill
- improve-animationsSkill
- keten-loopSkill
- make-interfaces-feel-betterSkill
- mobile-nativeSkill
- office-docsSkill
- pick-ui-librarySkill
- polijst-loopSkill
- polpohire-designSkill
- pre-pr-gatesSkill
- projectstructuurSkill
- prototypeSkill
- readmeSkill
- reaSkill
- redesign-existing-projectsSkill
- render-proofSkill
- repo-hygieneSkill
- review-animationsSkill
- skill-finderSkill
- speur-loopSkill
- supergoalSkill
- systematic-debuggingSkill
- theme-selectorSkill
- transitions-devSkill
- ux-heuristicsSkill
- waak-loopSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
16 rules. 0 are common, 16 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 128 edited versions we read keep these.
16
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Blind peer review: Before synthesis, each advisor rates the *other* anonymized positions on a rubric.
- Distinctive: line 44
Before convening, classify the decision:
- Distinctive: line 49
If the decision is genuinely a two-way door with low stakes, say so and just recommend.
- Distinctive: line 53
Default council is four voices for normal decisions, five for high-stakes.
- Distinctive: line 72
If the question is vague, ask one sharp clarifying question before convening.
- Distinctive: line 83
Before reading any advisor, write down privately:
- Distinctive: line 152
Do not dismiss an advisor's view without saying why.
- Distinctive: line 153
If an advisor changed your recommendation, say so explicitly.
- Distinctive: line 154
Always include the strongest dissent, even if you reject it.
- Distinctive: line 155
If two voices align against your prior, treat that as a real signal, not noise to argue away.
- Distinctive: line 156
If peer review ranked a position above yours, address it head-on.
- Distinctive: line 157
Keep the raw positions visible before the verdict.
- Distinctive: line 183
Keep it scannable on a phone screen.
- Distinctive: line 187
Default is one round. Run a second only if peer review left two positions tied on merit and the decision is a one-way door.
- Distinctive: line 190
keep one advisor (usually the Skeptic) clean of the prior round to preserve anti-anchoring value.
- Distinctive: line 192
Stop after the second round.
“Common” is measured: kept by at least 6 in 10 of the 128 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Council
Convene a council of independent advisors for decisions where one answer is not enough. Each advisor reasons with a distinct method, positions are gathered in parallel without anchoring, the advisors then rate each other blind, and a chairman synthesizes a verdict that keeps the disagreement visible.
This is for decision-making under ambiguity, not code review, implementation planning, or architecture drafting.
What makes this stronger than asking once
- Distinct reasoning methods, not just vibes. Each voice is bound to a named method (first-principles, inversion, outside-view, second-order, shipping-reality). Diversity of method is what surfaces blind spots.
- Anti-anchoring by construction. Advisor positions are produced by fresh subagents that receive only the question and minimal context, never the running conversation. The loudest framing in the chat cannot contaminate the panel.
- Blind peer review. Before synthesis, each advisor rates the other anonymized positions on a rubric. This weighs arguments on merit, not on who spoke first or longest.
- A chairman who must show its work. The synthesis preserves the raw positions and the strongest dissent, states a confidence level, and names what would change the verdict.
When to Use
- A decision has multiple credible paths and no obvious winner.
- Tradeoffs need to be made explicit before choosing.
- The user asks for second opinions, dissent, or multiple perspectives.
- Conversational anchoring is a real risk (you have already argued one side).
- A go / no-go call would benefit from adversarial challenge.
Examples: monorepo vs polyrepo, ship now vs hold for polish, feature flag vs full rollout, build vs buy, this vendor vs that one, simplify scope vs keep strategic breadth.
When NOT to Use
| Instead of council | Do this |
| Verifying whether an output is correct | Verify it directly or use an adversarial review pass |
| Breaking a feature into implementation steps | Plan it |
| Designing system architecture from scratch | Design it directly |
| Reviewing code for bugs or security | Run a code review |
| Straight factual questions | Just answer |
| Obvious execution tasks | Just do the task |
Council is for choosing between options, not for producing the options' implementation.
Right-size the deliberation first
Before convening, classify the decision:
- Reversibility. A two-way door (cheap to undo) deserves one fast round. A one-way door (expensive or impossible to undo) earns a full round plus peer review, and a second round if the panel splits.
- Stakes. Low stakes: 3 voices, single round, skip peer review. High stakes: 5 voices, peer review, optional second round.
If the decision is genuinely a two-way door with low stakes, say so and just recommend. Do not convene a council for a coin flip.
The Voices
Default council is four voices for normal decisions, five for high-stakes. You participate as the Chairman; the others are launched as independent subagents.
| Voice | Reasoning method | Lens |
| Architect | First-principles | Correctness, maintainability, long-term structural implications |
| Skeptic | Outside view / base rates | Challenge the premise, question assumptions, propose the simplest credible alternative |
| Pragmatist | Shipping reality | Speed, user impact, operational cost, cost of delay |
| Critic | Inversion / pre-mortem | Downside risk, edge cases, the failure modes that kill this |
| Strategist (5th, high-stakes only) | Second-order effects | Knock-on consequences, incentives, what this decision makes true 12 months out |
Workflow
1. Extract the real question
Reduce the decision to one explicit prompt:
- What are we deciding?
- What constraints are non-negotiable?
- What counts as success?
If the question is vague, ask one sharp clarifying question before convening. A council on the wrong question wastes the whole exercise.
2. Gather only the necessary context
- Codebase-specific decision: collect the few relevant files, snippets, metrics, or issue text. Keep it compact.
- Strategic or general decision: skip repo detail unless it materially changes the answer.
The context block you hand each advisor must be small enough that it does not smuggle in your preferred conclusion.
3. Write the Chairman's prior
Before reading any advisor, write down privately:
- your initial position,
- the three strongest reasons for it,
- the main risk in your preferred path.
Doing this first stops the synthesis from merely echoing whichever advisor wrote best.
4. Launch the advisors in parallel
Spawn each voice as a fresh independent subagent. Each gets the question, the compact context, and its role. None gets the conversation history. Launch them in a single batch so they run concurrently.
Prompt template per advisor:
You are the [ROLE] on an independent decision council. Your reasoning method is [METHOD].
Question:
[the one explicit decision question]
Context:
[only the relevant snippets or constraints, compact]
Respond in this exact shape:
1. Position - 1 to 2 sentences. Pick a side.
2. Reasoning - 3 concise bullets, argued from your method.
3. Risk - the single biggest risk in your own recommendation.
4. Blind spot - one thing the other advisors are likely to miss.
5. Confidence - low / medium / high, with a half-sentence why.
Rules: be direct, no hedging, no "it depends" without committing to a default. Under 250 words.Method emphasis to put in each advisor's prompt:
- Architect (first-principles): strip the problem to fundamentals, ignore convention, reason up from what must be true.
- Skeptic (outside view): how do decisions like this usually turn out, what is the base rate, what is the boring default that probably wins.
- Pragmatist (shipping reality): what ships fastest with least operational drag, what does the user actually feel, what does delay cost.
- Critic (inversion): assume it failed in a year, work backward, name the specific failure modes and edge cases.
- Strategist (second-order): what does this decision incentivize, what becomes hard later, what does it make true downstream.
5. Blind peer-review round (skip for low-stakes)
Strip the author labels from the advisor positions, shuffle them, and give the anonymized set to each advisor again (fresh subagent, no history). This catches the case where the loudest argument is not the best-reasoned one.
Peer-review prompt template:
Below are anonymized positions from a decision council on this question:
[question]
Positions (authors hidden):
[A] ...
[B] ...
[C] ...
[D] ...
For each position, score 1 to 5 on:
- Soundness: is the reasoning valid and well-supported?
- Insight: does it surface something non-obvious?
- Risk-honesty: does it own its own downside?
Then: name the single strongest position and the single weakest, and say in one line what the strongest one gets right that the others miss. Do not try to guess who wrote what.Aggregate the scores. A position that scores high across reviewers it did not write is a real signal, not just a confident author.
6. Synthesize as Chairman, with bias guardrails
You are both a participant and the synthesizer, so hold yourself to these:
- Do not dismiss an advisor's view without saying why.
- If an advisor changed your recommendation, say so explicitly.
- Always include the strongest dissent, even if you reject it.
- If two voices align against your prior, treat that as a real signal, not noise to argue away.
- If peer review ranked a position above yours, address it head-on.
- Keep the raw positions visible before the verdict.
7. Present a compact verdict
## Council: [short decision title]
**Architect:** [1-2 sentence position] - [1 line why]
**Skeptic:** [1-2 sentence position] - [1 line why]
**Pragmatist:** [1-2 sentence position] - [1 line why]
**Critic:** [1-2 sentence position] - [1 line why]
[**Strategist:** ... if convened]
### Peer review
- Top-rated position: [which, and the one thing it got right]
- Lowest-rated: [which, and why]
### Verdict
- **Consensus:** [where the voices genuinely align]
- **Strongest dissent:** [the most important disagreement, stated fairly]
- **Premise check:** [did the Skeptic land a hit on the question itself?]
- **Recommendation:** [the synthesized path]
- **Confidence:** [low / medium / high]
- **What would change this:** [the specific evidence or condition that flips the call]Keep it scannable on a phone screen. The value is not unanimity. The value is making the disagreement legible before choosing.
Second round (only when the panel genuinely splits)
Default is one round. Run a second only if peer review left two positions tied on merit and the decision is a one-way door. When you do:
- sharpen the question to the exact axis of disagreement,
- carry forward only the two contested positions,
- keep one advisor (usually the Skeptic) clean of the prior round to preserve anti-anchoring value.
Stop after the second round. A council that cannot converge in two rounds is signalling that you are missing information, not perspectives. Say that, and name the missing input.
Optional: genuine model diversity
The core skill runs entirely on this agent's own subagents and needs nothing else. If you happen to have other coding-agent CLIs installed (for example a second vendor's CLI), you can route one or two advisor seats to them for true cross-model diversity. This is optional and must never be a hard dependency: if those CLIs are absent, run the full council on native subagents without degradation. Do not introduce external API keys or paid routing to satisfy this.
Anti-Patterns
- Using council for code review or plain implementation work.
- Feeding the subagents the entire conversation transcript (defeats anti-anchoring).
- Letting the author labels leak into the peer-review round.
- Hiding disagreement inside a tidy consensus.
- Convening a five-voice council for a reversible, low-stakes coin flip.
- Running endless rounds instead of admitting you lack information.
Example
Question:
Ship the 2.0 alpha now, or hold until the control-plane UI is more complete?Likely council shape:
- Architect pushes for structural integrity and a coherent surface over a half-built UI.
- Skeptic questions whether the UI is actually the gating factor or just the visible one.
- Pragmatist asks what can ship now without burning user trust, and what holding costs.
- Critic runs the pre-mortem: support burden, expectation debt, rollout confusion.
- Peer review surfaces whether "hold" is genuinely strongest or just the cautious default.
The verdict makes the tradeoff legible, recommends a path, and names the one fact that would flip it.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

