design-review

Evaluate software design documents against PRDs for gaps and risks.

Updated Sep 13, 2025
One-click install
npx skills add https://github.com/nobelk/claude-tools --skill design-review-nobelk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/nobelk/claude-tools/tree/main/skills/design-doc-review
Command: npx skills add https://github.com/nobelk/claude-tools --skill design-review-nobelk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Conducting rigorous, principal-engineer-level reviews of software design documents to ensure PRD alignment, architectural soundness, and production-readiness.

Core Features & Use Cases

  • Systematic PRD alignment verification across architecture, data, API, security, reliability, and operations.
  • Structured, citation-backed evaluations with actionable recommendations and risk labeling.
  • Use cases include design doc critique, technology trade-off analysis, and production-readiness assessment.

Quick Start

Instruct the assistant to perform a comprehensive design review against the PRD and return a prioritized, evidence-backed report.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I conduct a principal-grade software design review against a PRD?

Automate principal-grade evaluation of software design documents against PRDs to surface gaps, risks, and actionable improvements. Apply this to architecture reviews, system design proposals, and production-readiness assessments across complex diagrams and ADRs.

What is included in a comprehensive architecture and system design evaluation?

A comprehensive architecture and system design evaluation includes systematic PRD alignment verification across architecture, data design, API interfaces, security, reliability, and operations, outputting a prioritized, evidence-backed assessment report.

How do I assess production-readiness for complex software systems?

Assess production-readiness by performing structured, citation-backed evaluations of ADRs and system design proposals against the PRD to identify architectural gaps, label operational risks, and output a prioritized assessment.

Can I use a structured checklist to critique technology trade-offs in design documents?

Yes, you can use a structured checklist to critique technology trade-offs in design documents. The evaluation provides citation-backed recommendations and risk labeling for architecture, API, and reliability decisions.

Do I need to provide references and a PRD to perform a design doc critique?

Yes, performing a design doc critique requires providing references for context and a PRD for alignment verification. The evaluation uses these inputs to output a prioritized, evidence-backed assessment of your design.

What is the best way to verify PRD alignment across security and reliability dimensions?

The best way to verify PRD alignment across security and reliability dimensions is to automate a principal-grade evaluation using a structured checklist, which systematically checks these areas and outputs a prioritized risk assessment.