design-review

Review product design documents for completeness, consistency, and implementability.

70|42|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/tranhieutt/software_development_department --skill design-review-tranhieutt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/tranhieutt/software_development_department/tree/main/.claude/skills/design-review
Command: npx skills add https://github.com/tranhieutt/software_development_department --skill design-review-tranhieutt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures product design documents are complete, consistent, and implementable before they reach engineering, avoiding hand-off delays and rework.

Core Features & Use Cases

  • Checklist Enforcement: Validates that every required section (overview, user fantasy, rules, formulas, edge cases, dependencies, tuning knobs, and acceptance criteria) is present and explained.
  • Consistency & Cross-System Audit: Detects contradictions, missing dependencies, and tone mismatches by reading the target doc, CLAUDE.md, and related design references.
  • Implementability Review: Flags vague rules, missing performance considerations, and unscoped tuning knobs, guiding authors toward actionable precision.
  • Use Case: Before sharing a new system PRD with engineers, invoke this Skill to produce a structured review with completeness score, concerns, recommendations, and next skill guidance.

Quick Start

Request a comprehensive design review by running /design-review design/docs/new-feature.md to confirm the doc meets the department standards.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I check if a design doc is ready for engineering handoff?

A design review audit targets UX and product design workflows by checking documents for completeness, consistency, and implementability before stakeholder teams receive them. It reads the target doc and related references to detect contradictions and missing dependencies.

How do I audit cross-system consistency in UX specifications?

Cross-system consistency audits detect contradictions, missing dependencies, and tone mismatches by reading the target design doc alongside CLAUDE.md and related references. The review output captures these consistency notes to prevent rework across interconnected systems.

What is the best way to flag vague rules and unscoped tuning knobs in a PRD?

The best way to flag vague rules and unscoped tuning knobs is an implementability review that identifies missing performance considerations and guides authors toward actionable precision. It produces structured concerns and recommendations for specification refinement.

Can I use a checklist to enforce required sections in product design documents?

Yes, you can enforce checklist validation for product design documents to ensure every required section is present and explained. This checklist enforcement covers overview, user fantasy, rules, formulas, edge cases, dependencies, tuning knobs, and acceptance criteria.

What should a design review output include for stakeholder teams?

Limitations of design review automation include the inability to assess subjective visual aesthetics or validate undocumented implicit logic outside the provided text. It strictly evaluates completeness, consistency, and implementability based on the explicit content within the design docs and references.