design-review

Runs a multi-persona presentation review of an Astro site with evidence capture, parallel critics, and an HTML report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a personal site's visual quality by hand is inconsistent: reviewers re-measure the same things, findings lack evidence, and recommendations conflict with the site's own design rules. This Skill structures the entire review as a repeatable pipeline with verified evidence and calibrated outcomes. ## Core Features & Use Cases - Evidence-first capture: Builds the site, drives a real browser session per route, and produces a facts sheet of computed styles, geometry, and accessibility trees before any judgment happens. - Parallel critic lanes: Spawns Opus subagents for craft, spec conformance against DESIGN.md, an impeccable-skill audit, and persona walkthroughs (recruiter, engineer, curious visitor), each returning schema-conformant findings. - Synthesis and calibration: Dedupes findings into ranked tiers (clear problems, weak spots, direction questions, doc corrections), publishes one annotated HTML report, and converts accepted direction questions into permanent Rulings in DESIGN.md. - Use Case: After shipping layout changes to the site, run the review to get a verified, prioritized list of presentation defects with concrete fixes, while deliberate design decisions are protected from being flagged as bugs. ## Quick Start Ask the agent to run the design review on the site and produce the HTML report with ranked findings.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I run a design review on my Astro site?▼

Build and preview the site with bun, then capture browser evidence per route including screenshots and accessibility snapshots. The skill coordinates parallel critic agents that evaluate craft, spec conformance, and user personas, then synthesizes findings into one HTML report.

What does a multi-persona website review check?▼

It checks visual hierarchy, typography, information architecture, accessibility, and interaction through live keyboard testing and axe scans. Persona critics browse as a recruiter, an engineer arriving from search, and a visitor trying to know the person, reporting friction only.

Does the design review evaluate the writing or article content?▼

No, article prose is explicitly out of bounds. Copy counts only as UI elements like labels, headers, and standfirsts, and any copy proposals must be calibrated against the author's existing writing and offered as selectable variants.

How are review findings prioritized and verified?▼

Every finding must cite screenshot evidence and a computed value from the shared facts sheet. Synthesis sorts findings into clear problems, weak spots, direction questions, and doc corrections, with the number of independent critics determining confidence rank.

When should fixes be applied after a design review?▼

Fixes happen in a separate pass only on request, after the calibration gate where the owner answers direction questions. Implementation agents get disjoint file lists, fix structural mechanisms rather than symptoms, and every commit is gated by build and lint checks.