alirezarezvani/claude-skills / product-team/design-qa/skills/design-qa
design-qa
VerifiedUse when a UI screen, page or component is about to be called done, handed off or shipped, or when generated UI looks generic or half-finished. Gates the rendered result, not the design file - finds controls that do nothing, placeholder copy, removed focus rings, missing loading/empty/error states, low contrast, small targets, hidden focus and broken reflow measured in the real browser, and flags template defaults without blocking on taste.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.5 KB |
| assets/capture_snapshot.mjs | script | 3.4 KB |
| assets/collect_snapshot.js | script | 9.6 KB |
| assets/finish_signoff.md | markdown | 1.8 KB |
| assets/snapshot.example.json | config | 3.1 KB |
| assets/states.example.csv | other | 1.2 KB |
| assets/waivers.example.csv | other | 263 B |
| references/generic_ui_defaults.md | markdown | 6.4 KB |
| references/interaction_states.md | markdown | 5.9 KB |
| references/rendered_checks_wcag22.md | markdown | 6.7 KB |
| scripts/finish_lint.py | script | 17.8 KB |
| scripts/rendered_audit.py | script | 16.9 KB |
| scripts/state_matrix_checker.py | script | 11.8 KB |
assets/finish_signoff.md
View on GitHub# UI finish sign-off
Fill this in from the script runs before a screen is called done. Paste
verdict lines, not summaries. A BLOCKED line means the screen is not done.
**Screen / flow:**
**Build or commit:**
**URL and viewports captured:** 320 × ___ and ___ × ___
**Brief or design file:**
**Reviewer (a person, not the agent):**
## 1. Finish lint (`finish_lint.py`)
- Verdict line:
- Blockers fixed:
- Suppressions added, each with its reason:
- Template traits and generic risk:
- If generic risk is MEDIUM or HIGH, does the brief ask for this look? (yes, quote it / no, and what was changed)
## 2. State matrix (`state_matrix_checker.py`)
- Verdict line and coverage %:
- States marked NA and why:
- Product-specific states added with `--require`:
## 3. Rendered audit (`rendered_audit.py`), once per viewport and per key state
| Snapshot | Viewport | State | Verdict | Blockers | Waivers |
|---|---|---|---|---|---|
| | 320 | populated | | | |
| | desktop | populated | | | |
| | 320 | empty | | | |
| | desktop | error | | | |
- Focus data came from a real keyboard pass (`capture_snapshot.mjs`): yes / no
- CONTRAST_UNVERIFIED items checked by hand, with the lowest ratio found:
## 4. Not covered by the scripts (check by hand)
- [ ] Screen reader pass on the main flow (labels make sense, errors are announced)
- [ ] Copy read aloud once: every button says what happens, every error says what to do
- [ ] Real data: longest real name, largest real list, slowest real network
- [ ] Source accessibility scan with `a11y-audit` (alt text, labels, ARIA, headings)
## Decision
- [ ] Ship: no blockers, every waiver has a WCAG exception or a ticket
- [ ] Ship with follow-ups (list ticket ids):
- [ ] Not done: blockers remain
Signed: ______________________ Date: ____________
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |