Local Council Execution
Run multiple Claude perspectives on a question without external AI providers.
Installation
- Make sure Claude is on your device and in your terminal.
Skills load from
~/.claude/skills/when Claude Code starts up β so you need it on your machine first. If you don't have it yet, install it once with the command below, then runclaudein any terminal to verify.One-time setupnpm i -g @anthropic-ai/claude-codeAlready have it? Skip ahead.
- Paste into Claude Code or into your terminal.
This copies the whole skill folder into
~/.claude/skills/local-council-execution-hex/β the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.Faster alternative (instruction-only skills)
Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates β they won't be downloaded and the skill will fail when it tries to load them.
Quick install (SKILL.md only)Sign up to copy - Restart Claude Code.
Quit and reopen Claude Code (or any other agent that loads from
~/.claude/skills/). New skills are picked up on startup. - Just ask Claude.
Skills auto-activate when your request matches the skill's description β no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the βWhat this skill doesβ section above.
Prefer to read the source first? Open on GitHub.
When Claude uses it
Runs a local council when no external AI providers are configured. Spawns N independent Claude subagents (one per role, blind to each other) that each answer the question from a single assigned lens, then synthesizes their perspectives. Invoked by the ask command via --local, or when the user accepts the local-council offer after no providers are found. This is a same-model (Claude-only) panel, not a cross-vendor council.
What this skill does
Local Council Execution
When no external providers are configured, convene a council of independent Claude subagents instead. Each member answers from one role, blind to the others; you then synthesize the spread of perspectives.
Read this first β the honest framing is not optional. Every member is Claude. They share priors and training, so agreement between them is weak signal, not validation. The value here is independent angles and blind-spot coverage, not consensus. The output you produce MUST make this explicit and MUST NOT present member agreement as if it were cross-vendor corroboration.
Step 0: Confirm this is a local-council context (guard)
A local council is the fallback for when no real providers exist β it is not a default way to "use the council". Only proceed if one of these holds:
- The user explicitly passed
--local, or - There are no configured providers and the user accepted the local-council offer.
If you reached this skill any other way, verify providers are actually absent before spawning anything:
bash ${CLAUDE_PLUGIN_ROOT}/scripts/query-council.sh --list-default 2>&1 | head -1
If that lists one or more providers and the user did not ask for --local,
STOP β do not spawn local members. Run the standard cross-vendor flow
(council-execution) so the real providers answer, since same-model role-play is
strictly weaker than the cross-vendor council the user can actually get.
Step 1: Resolve the roles
Source the libs once:
source ${CLAUDE_PLUGIN_ROOT}/scripts/lib/prompts.sh
source ${CLAUDE_PLUGIN_ROOT}/scripts/lib/roles.sh
If the user passed --roles, it already says both which lenses and how many
members β use it directly and skip the size question:
local_council_roles "<--roles value>"
Otherwise, ask the user how many members to convene, then resolve that many:
AskUserQuestion:
Question: "How many independent perspectives should the local council convene? More members means broader angle coverage, but a longer run and synthesis."
Header: "Members"
multiSelect: false
Options:
- "4 (Recommended) - balanced breadth"
- "3 - quick, three sharpest lenses"
- "5 - thorough"
- "6 - exhaustive"
Then pass the chosen number as the count:
local_council_roles "" "<chosen number>"
local_council_roles returns a comma-separated role list (e.g.
devil,simplicity,security,scalability). Each role becomes one council member;
N = number of roles. It draws from a diverse ordering and clamps to the 8
available roles β a user who wants more or specific lenses can pass --roles
(e.g. --roles=security,devil,simplicity,scalability,dx,compliance). If you want
to be safe, validate_roles "<list>" returns non-zero on an unknown role.
Step 2: Assemble the question + context
Build the text each member will answer:
- The user's question.
- Any file context gathered via
--fileor auto-context (the same context the cross-vendor flow would send). Include it inline so members can reason about it even though they will also read referenced files themselves.
Step 3: Spawn the members in parallel
For each role, build the role-injected prompt and spawn one member. See
agent-prompt-template.md for the exact prompt and the
build_prompt_with_role call.
Launch all members in a single message (multiple Agent tool calls) with:
subagent_type: "general-purpose"run_in_background: true
The member framing (independent, blind to the others, commit to the assigned lens, return format) lives in the prompt itself β see the template. Launching them together runs them concurrently and keeps each one blind to the others.
Step 4: Collect results
You are notified automatically as each background member finishes. Wait for ALL of them before synthesizing. If a member fails or times out, note it and continue with the rest.
Step 5: Display each perspective
Lead with this banner verbatim (it sets honest expectations):
Local council β these perspectives all come from Claude playing different roles, not from different AI vendors. Treat agreement as a shared starting point to pressure-test, not as independent confirmation.
Then, for each member, display its perspective under a header naming the role
(use get_role_name "<role>" for the display name):
## π³οΈ {ROLE_NAME}
{member's Position / Key points / Risks & blind spots / Confidence}
Step 6: Synthesize β angles, not consensus
Because members share a model, frame the synthesis around spread and coverage, NOT agreement strength:
- Shared starting points β where members converged. Explicitly note this is a common prior to stress-test, not corroboration, and ask what they might all be missing for the same reason.
- Genuine tensions β where the roles pull in different directions, and what the user's specific situation implies about which tension matters most here.
- Blind spots β risks raised by one member that the others' approaches would walk into. Also flag anything no member covered.
- Suggested direction β your best synthesized recommendation, naming which roles support it and where the real uncertainty remains.
Step 7: Save output
mkdir -p .claude/council-cache
Write the full output (banner + all member perspectives + synthesis) to
.claude/council-cache/local-council-{TIMESTAMP}.md where TIMESTAMP is the
current Unix timestamp. Then tell the user:
Local council saved to
.claude/council-cache/local-council-{TIMESTAMP}.mdFor cross-vendor perspectives, configure a provider key or install a CLI (/claude-council:statusshows what's available).
Error Handling
- If a member fails, show the failure and continue with the others.
- If ALL members fail, report clearly and suggest retrying.
- If only one role resolved, say so β a one-member "council" is just a single role-played answer, and the user should know that.
Related skills
App Store Listing Audit
coreyhaines31
Analyze your app listing against best practices and get a prioritized optimization plan.
Co-Marketing Partnerships
coreyhaines31
Find ideal partners and plan joint marketing campaigns with other companies.
Cold Email Writer
coreyhaines31
Write B2B cold emails and follow-up sequences designed to get replies.
Community-Led Growth
coreyhaines31
Build and grow online communities to drive product adoption and customer loyalty.