review-design

Review draft design documents and append feedback to a Review Log.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mattschwartz/systemos --skill review-design-mattschwartz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-design
Source: https://github.com/mattschwartz/systemos/tree/main/.claude/skills/review-design
Command: npx skills add https://github.com/mattschwartz/systemos --skill review-design-mattschwartz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews of design proposals are needed to surface gaps, risks, and actionable improvements before implementation.

Core Features & Use Cases

  • Structured critique: Provide role-aligned feedback highlighting assumptions, gaps, and risks.
  • Traceable revisions: Append a Review Log with actionable feedback and open questions while preserving the original proposal.
  • Context-aware guidance: Load the recommended resources and frontmatter-defined role context to tailor feedback.

Quick Start

Review the draft proposal at the given path and attach feedback into the proposal document.

Frequently Asked Questions about review-design

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

FAQPage Schema
How do I review a design proposal to surface gaps and risks?

To review a design proposal, load required context resources and apply role-aligned feedback to highlight assumptions, gaps, and risks. This process ensures structured critique during early design phases by appending a Review Log with actionable feedback while preserving the original document content for traceability.

What is the best way to add feedback to a draft design document without losing the original content?

The best way to add feedback to a draft design document while preserving original content is appending a Review Log entry. This method attaches actionable feedback and open questions directly into the proposal, maintaining full traceability of revisions and ensuring the base draft remains intact.

Can I use role-specific context to critique an SDLC design proposal?

Yes, you can critique an SDLC design proposal using role-specific context. The review process loads frontmatter-defined role context to tailor feedback, ensuring the structured critique aligns with specific reviewer perspectives and accurately surfaces relevant gaps, assumptions, and risks.

How does a structured design review improve the software development lifecycle?

A structured design review improves the software development lifecycle by surfacing gaps, risks, and actionable improvements before implementation begins. Conducting early reviews of draft proposals ensures assumptions are challenged and open questions are documented, reducing costly downstream errors.