design-review

Reviews consolidated design summaries by dispatching a fresh reviewer subagent with a three-dispatch budget.

3|3|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/philipobenito/elelem --skill design-review-philipobenito
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/philipobenito/elelem/tree/main/skills/design-review
Command: npx skills add https://github.com/philipobenito/elelem --skill design-review-philipobenito

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Section-by-section design approval misses cross-cutting problems like contradictions between sections, missing components, and ambiguous requirements. This Skill runs a holistic review pass over a consolidated design summary before final user approval, catching what incremental review overlooked. ## Core Features & Use Cases - Isolated reviewer dispatch: Sends the design summary alone to a fresh reviewer subagent with no session history, so the design is graded on its own text rather than the conversation around it. - Determined vs. undetermined triage: Fixes issues the design already answers and returns genuine open decisions to the caller instead of guessing on the user's behalf. - Bounded fix-and-re-review loop: Applies fixes and re-dispatches up to three times, then escalates to a human rather than looping indefinitely. - Use Case: Inside a design-dialogue workflow, after the user consolidates a design for a new ingest pipeline, this Skill reviews the summary, fixes a determined interface ambiguity, flags an undecided malformed-record policy as an open decision, and returns both to the caller. ## Quick Start Invoke this skill from a design workflow once the design is consolidated into a single self-contained summary, and it will dispatch the reviewer and return an approved summary, open decisions, or an escalation.

Frequently Asked Questions about design-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a software design document with an AI agent?

Consolidate the design into a single self-contained summary, then dispatch a fresh reviewer subagent against that text alone with no session history. The reviewer checks completeness, consistency, clarity, scope, and YAGNI, and returns Approved or a list of specific issues.

How to handle open questions found during a design review?

Classify each issue as determined or undetermined. Fix determined issues the design already answers, but return undetermined ones to the caller as open decisions, since resolving them requires a choice the design never made and only the user can make it.

Can this design review skill be used standalone?

No. It runs only as a step inside a design skill such as design-dialogue or design-committee, after the design is consolidated and before final user approval. A design summary handed straight to Claude belongs to the design skill that owns it.

Why should the reviewer subagent not receive session history?

Passing session history violates context isolation: the reviewer would grade the conversation rather than the design itself. The summary must stand alone so anything missing from it is surfaced as a review finding.

What happens when a design review never converges?

The skill enforces a three-dispatch budget per invocation. If issues remain after the third dispatch, it returns Issues outstanding with the current summary, and the caller must stop and put the decision to the user rather than dispatching again.