design-review

Analyze web pages against design specs and accessibility standards to generate annotated issue reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, pyyaml, pillow, and includes scripts (resource) components.

What problem does it solve?

Design Review helps product teams verify UI implementations against design specs and accessibility standards, surfacing issues, generating annotated visuals, and producing actionable task lists.

Core Features & Use Cases

  • Annotated visual reviews: compare UI against design specs and generate annotated screenshots with issues.
  • Accessibility checks with automated task generation to guide fixes.
  • Use Case: inspect a new web app against brand guidelines and export DESIGN-REVIEW-TASKS.md for engineers and designers.

Quick Start

Use the design-review skill to run a full-page audit against http://localhost:3000: uv run .claude/skills/design-review/scripts/design_review.py review http://localhost:3000

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I automate UI design reviews against a design spec?

Automated UI design reviews compare live web pages against design specs and accessibility standards, surfacing visual discrepancies and generating annotated screenshots. This Skill uses Playwright to load pages and Pillow to annotate issues directly onto captured visuals.

Can I generate actionable task lists from accessibility checks on a web app?

Accessibility checks generate actionable task lists by scanning web app pages for standards violations and exporting the findings into a markdown file. The Skill produces a DESIGN-REVIEW-TASKS.md output that engineers and designers can follow to fix identified issues.

What's the best way to annotate screenshots for UI QA workflows?

Annotating screenshots for UI QA involves capturing full-page web visuals and overlaying issue markers where the implementation deviates from the design spec. This Skill leverages Python and Pillow to programmatically draw annotations onto screenshots for clear visual feedback.

Do I need Playwright and Python to run automated web page accessibility checks?

Playwright and Python are required dependencies to run these automated web page accessibility checks. Playwright handles browser automation to load and render the target URL, while Python executes the review logic, with optional axe-core integration for deeper standards validation.

Does this design review tool work with local development servers?

This design review tool works with local development servers by pointing the review script at a localhost URL. Running the Python script against http://localhost:3000 executes a full-page audit, analyzing the locally served UI against the provided design spec.

What limitations exist when using Playwright for visual spec-driven reviews?

Spec-driven visual reviews using Playwright are limited to checking what renders in the browser DOM and visually on the captured screenshot. Complex interactive states requiring specific user authentication flows or dynamic animations may not be fully captured in a single automated audit pass.