design-review

Audit design documentation health, completeness, and cross-reference integrity across modules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Design documentation often drifts from current project reality, creating silos and confusion when teams try to audit health, identify gaps, and align maintenance. This skill provides a structured approach to evaluating design docs, surface gaps, and deliver actionable remediation.

Core Features & Use Cases

  • Health checks across frontmatter, structure, references, and maintenance signals
  • Cross-document and cross-module reference validation to improve traceability
  • Actionable reporting with prioritized recommendations and next steps
  • Use Case: run a module design review to produce a health report and cross-link missing references

Quick Start

Run /design-review <module-name> to generate a health report for that module.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I audit design documentation health and consistency across modules?

To audit design documentation health, run a module design review that checks frontmatter presence, section coverage, cross-reference validation, and maintenance signals to produce a structured health report.

What is cross-reference validation in design docs and when do I need it?

Cross-reference validation in design docs verifies that links between documents and modules resolve correctly. You need it when auditing traceability to surface gaps and prevent documentation drift from current project reality.

How do I check frontmatter presence and section coverage in design documentation?

Checking frontmatter presence and section coverage involves scanning design docs to ensure required metadata fields and structural sections exist. The review produces actionable reports with prioritized recommendations for missing elements.

Can I use a design review to identify maintenance signals and documentation gaps?

Yes, a design review identifies maintenance signals and gaps by evaluating design docs for completeness and cross-reference integrity. It delivers actionable remediation steps to align documentation with the current project state.

What's the best way to generate a structured health report for module design docs?

The best way to generate a structured health report is running an automated design review that evaluates frontmatter, structure, references, and maintenance signals, producing prioritized next steps for remediation.

Does design documentation review work without external dependencies?

Design documentation review works without external dependencies because it operates as a self-contained audit. It directly evaluates design docs for health, completeness, and cross-reference integrity to output structured remediation recommendations.