Clarity council

Skill risadams/skills/clarity-council

An opinionated library of reusable agent skills. Contains practical skills for writing, planning, triage, architecture, and workspace workflows

Install

npx -y skills add risadams/skills --skill clarity-council

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Facilitates structured single-persona or multi-persona consultation for strategy, product, engineering, operations, and risk decisions. Use when the user requests a council, multiple perspectives, persona advice, tradeoff analysis, or iterative clarification and debate.

SKILL.md

4.1 KB, as published. Nobody here has run it

Clarity Council: Agent-Based System

This skill routes to three specialized agents in the agents/00-council/ folder. Use the appropriate agent based on your decision-making need.

When to use

Use this system when you need any of the following:

Quick expert opinion from one persona
Multiple expert viewpoints with synthesis
Iterative decision-making with clarifications
Structured tradeoff analysis

Do not use for pure factual lookup with no decision component.

Which Agent to Use?

Single Expert Perspective

Agent: council-single-persona
When: You need focused advice from one expert (quick, 10–15 min)
Example: "As a senior-architect, should we migrate to microservices?"

Multiple Expert Synthesis

Agent: council-multi-persona
When: A decision needs multiple viewpoints synthesized (20–30 min)
Example: "Convene a council on Kubernetes adoption."

Iterative Decision-Making

Agent: council-iterative
When: You need multi-turn iteration with clarifications (30–60 min, 3–5 turns)
Example: "Run a council on team restructuring. I'll iterate."

Agent Invocation

Simply invoke the appropriate agent directly:

/council-single-persona
  As a product-owner, should we ship this quarter?

/council-multi-persona
  Convene a council on whether to adopt TypeScript.

/council-iterative
  Run a council on payment processor selection. I'll iterate.

See the full documentation at agents/00-council/README.md and agents/00-council/INDEX.md.

Output templates

Use these structures exactly unless the user asks for a different format.

Single persona output

summary: <short answer>
advice:
- <point>
assumptions:
- <assumption>
questions:
- <question>
next_steps:
- <action>
confidence: <low|medium|high>

Multi-persona output

responses:
- persona: <name>
  summary: <short answer>
  advice:
  - <point>
  assumptions:
  - <assumption>
  questions:
  - <question>
  next_steps:
  - <action>
  confidence: <low|medium|high>

synthesis:
  agreements:
  - <point>
  conflicts:
  - <point>
  risks_tradeoffs:
  - <point>
  next_steps:
  - <action>

Multi-turn discussion output

status: <needs_clarification|in_progress|completed>
message: <short user-facing response>
nextAction: <what is needed next>
output:
  <single-persona or multi-persona structure>
state:
  sessionId: <id>
  turn: <number>
  history:
  - <compact turn summary>

Reference Files

Agent documentation:

agents/00-council/README.md — Comprehensive guide to all agents
agents/00-council/INDEX.md — Quick navigation and decision tree
agents/00-council/council-single-persona.md — Single expert agent
agents/00-council/council-multi-persona.md — Multi-expert synthesis agent
agents/00-council/council-iterative.md — Iterative decision agent

Persona library:

skills/personas/PERSONAS.md — Full persona index
skills/personas/GROUPS.md — Pre-made persona panels
skills/personas/*.md — Individual persona contracts (35+ total)

Quality checks

Before finalizing a response:

ensure recommendations tie to stated constraints
separate assumptions from facts
include at least one concrete next step
include at least one explicit risk or tradeoff for non-trivial decisions
keep terminology consistent with persona names in skills/personas/PERSONAS.md