Council Skill

A practical expert-review protocol for Codex, Claude Code, and AI coding agents. Invoke /council before implementation, refactoring, redesign, debugging, or architecture decisions.

View on GitHub Install the skill

/council

Industry: legal case-management software.
Task: Review this dashboard architecture.

- Domain/Product Expert
- Principal UI/UX Designer
- Principal Software Architect
- QA/Security/Ops Lead

Structured review before code

Council is not theatrical roleplay or a claim of hidden chain-of-thought. It gives the agent a visible audit trail: assumptions, objections, tradeoffs, implementation plan, and final decision.

Domain/Product Expert

Checks real workflows, business rules, user expectations, regulations, and domain edge cases.

Principal UI/UX Designer

Reviews information architecture, accessibility, usability, visual hierarchy, copy, and friction.

Principal Software Architect

Reviews architecture, data flow, APIs, state, maintainability, dependencies, and complexity.

QA/Security/Ops Lead

Reviews tests, regressions, security, privacy, performance, deployment, monitoring, and rollback.

Install for Codex and Claude Code

The repository includes safe Bash installers for Codex, Claude Code, or both. Existing Council skill folders are backed up before replacement.

git clone https://github.com/saroo98/council-skill.git
cd council-skill
./install-both.sh

Use it when the decision has real risk

Council is useful for feature planning, risky refactors, product redesigns, architecture decisions, debugging sessions, and specialized industry workflows.

Review an appointment-booking redesign for dental clinic software.
Evaluate KYC onboarding changes in fintech before implementation.
Challenge dashboard architecture for legal case-management software.
Plan a production incident debugging path before refactoring.

FAQ

Does Council create real subagents?

No. This repository is an instruction-only skill. It gives one coding agent a structured review protocol.

Is Council a replacement for tests or expert review?

No. It improves review discipline, but users should still verify claims, inspect code, and run relevant checks.

What command invokes the skill?

Use /council in compatible Codex, Claude Code, or AI coding agent environments.