# Critique Spec

> Have your synthetic personas critique a spec, PRD, or product idea — individual in-character reviews plus a panel synthesis

- Skill: `alaimo-labs/critique-spec` (Agent Skill)
- Install (CLI): `npx skillmds@latest add alaimo-labs/critique-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alaimo-labs/critique-spec/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: alaimo-labs (https://skillmd.com/u/alaimo-labs)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/alaimo-labs/critique-spec

---


# /critique-spec

Run a persona critique panel over a document, following the `persona-critique` skill.

Input: $ARGUMENTS

## Workflow

1. **Resolve the document.** A file path (look in `product/specs/` first), pasted content, or an idea described inline. If nothing resolvable, ask.

2. **Resolve the panel.** Named personas from `product/personas/`, or all of them by default (cap at 4 — if more exist, propose the 4 most relevant to this document and let the user adjust). If none exist, suggest `/generate-personas`. State the panel's type mix in one line ("2 primary, 1 tertiary, 1 negative"). A panel of only `primary` personas returns a complacent reading: when the document has purchase, permission, or scope implications, propose adding at least one `tertiary` or `negative` — and if none exists, suggest `/generate-personas` for the gap in one line. A persona without a `type:` line gets one proposed from its content, written into the file only with the user's approval.

3. **Critique.** Each persona reviews the document in character per the `persona-critique` skill: rating, strengths, concerns, suggestions — honest, literacy-aware, in the document's language.

4. **Synthesize** as the researcher: agreements, conflicts (design tensions), and the 2–3 highest-impact changes.

5. **Save** to `product/insights/{YYYY-MM-DD-HHMM}-critique-{spec-slug}.md` and offer the natural next step in one line (e.g., revise the spec, or slice it with `/slice-feature`).

