reviewing-design-docs

Automate structured design document reviews against Lyft tech spec templates.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews of design documents can be inconsistent and time-consuming. This skill provides a structured, repeatable process that surfaces gaps, aligns with Lyft tech spec templates, and facilitates a clean handoff to milestone planning.

Core Features & Use Cases

  • Structured four-phase review: Format verification, Section-by-Section review, Iterative updates, and Handoff.
  • Task-tracking integration with dedicated checkpoints for each section to ensure coverage and accountability.
  • Supports the open questions workflow and provides traceable handoff instructions for milestone planning.

Quick Start

Run the design-review workflow on your design document with the command /review-and-validate-design

Frequently Asked Questions about reviewing-design-docs

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

FAQPage Schema
How do I automate design document reviews to surface gaps before handoff?▼

Automating design document reviews involves running a structured workflow that verifies format, evaluates sections iteratively, and tracks open questions. This process enforces evidence-based criteria across Summary, Background, Goals, Non-Goals, Plan, Milestones, Measurable Impact, and Open Questions to ensure alignment.

What is the best way to align a design doc with the Lyft tech spec template?▼

Aligning a design doc with the Lyft tech spec template requires a section-by-section evaluation against evidence-based criteria. A structured review process guides you through format verification, iterative updates, and handoff to ensure all required sections like Milestones and Measurable Impact are covered.

How do I track open questions and task ownership during a design review?▼

Tracking open questions during a design review requires task-tracking integration with dedicated checkpoints for each section. This ensures coverage and accountability by assigning ownership to open questions and enforcing defined handoff steps for milestone planning.

Can I review design documents at any abstraction level using a structured process?▼

You can review design documents at any abstraction level using a structured four-phase process. The review applies format verification, section-by-section evaluation, iterative updates, and handoff to identify gaps and ensure alignment with tech spec templates.

Does the design review process support milestone planning and handoff?▼

The design review process supports milestone planning through defined handoff steps. After format verification, section-by-section review, and iterative updates, it provides traceable handoff instructions and integrates task-tracking to transition directly into milestone planning.

Why should I use a structured workflow for design doc validation instead of manual checks?▼

Structured design doc validation prevents inconsistent and time-consuming manual checks by enforcing evidence-based criteria across all sections. A repeatable four-phase process surfaces gaps, tracks open questions, and ensures clean handoff to milestone planning.