design-review
SKILL.md
Design Review
Overview
Use this skill to convert subjective design feedback into prioritized, evidence-based decisions that unblock implementation.
Scope Boundaries
- Use this skill when the task matches the trigger condition described in
description. - Do not use this skill when the primary task falls outside this skill's domain.
Shared References
- Severity calibration guidance:
references/design-review-severity-guidance.md
Templates And Assets
- Findings template:
assets/design-review-findings-template.md
- Approval decision log:
assets/design-review-decision-log-template.md
Inputs To Gather
- Review target (screens, flows, interaction states) and intended users.
- Acceptance criteria and non-negotiable constraints.
- Accessibility and localization expectations for in-scope surfaces.
- Delivery timeline and risk tolerance for unresolved issues.
Deliverables
- Findings list with severity, user impact, engineering impact, and owner.
- Explicit approval decision: approved, conditional approval, or rejected.
- Remediation plan with due dates and verification method.
- Residual risk statement for any deferred non-blocker issues.
Quick Example
- Blocker: keyboard focus order breaks checkout completion.
- Major: ambiguous copy causes wrong destructive action selection.
- Minor: visual rhythm inconsistency without measurable task impact.
- Decision: reject due to blocker; re-review only affected flow after fix.
Quality Standard
- Findings are reproducible and linked to concrete evidence.
- Severity reflects impact, not reviewer preference.
- Blockers are separated from improvements and tracked independently.
- Approval decision is auditable and tied to explicit criteria.
Workflow
- Confirm review scope, criteria, and decision authority.
- Evaluate critical user journeys before secondary surfaces.
- Log findings with impact, severity, and remediation guidance in
assets/design-review-findings-template.md. - Resolve or defer issues using explicit risk acceptance rules and
references/design-review-severity-guidance.md. - Publish final decision and follow-up actions in
assets/design-review-decision-log-template.md.
Failure Conditions
- Stop when review scope or acceptance criteria are ambiguous.
- Stop when critical flows cannot be validated end-to-end.
- Escalate when blocker findings remain open near implementation handoff.
Weekly Installs
4
Repository
kentoshimizu/sw…t-skillsGitHub Stars
4
First Seen
14 days ago
Security Audits
Installed on
opencode4
gemini-cli4
codebuddy4
github-copilot4
codex4
kimi-cli4