design-critique
Skill1 starsChanged 46 days agoMITView on GitHub
Runs a structured critique of a screen or flow: frames the goal and stage, walks Nielsen's 10 heuristics plus hierarchy, clarity, consistency, and craft passes, and reports each issue with a location, a 0–4 severity, and observation, impact, and suggestion. Works from screenshots, Figma links, or live URLs. Use for "critique this", "review my design", "what's wrong with this screen", "heuristic evaluation", or "feedback on this flow". Not for testing with real users (use usability-testing) or a WCAG audit (use accessibility-review).
37 other projects use a version of this.
Adopted by
Most recently taken up by
- nisarth/claude-skills-storetheir own version, first seen Nov 8, 2026
- Tcuzzo/backs-aios-skillstheir own version, first seen Nov 1, 2026
- davisbuilds/dojotheir own version, first seen Nov 1, 2026
- vijaysuperpositionist/skillstheir own version, first seen Nov 1, 2026
- ArnavPuri/designskillstheir own version, first seen Nov 1, 2026
- microsoft/amplifier-app-papercliptheir own version, first seen Oct 25, 2026
Used with
Projects with it also use presentation-design, accessibility-audit and 5 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ArnavPuriSkillpresentation-design
Design slide decks as HTML/CSS (custom or reveal.js): slide layouts on a fixed 16:9 canvas, presentation typography, slide charts, builds and transitions, speaker notes, and PDF export. Use for decks presented or shared from the browser; for native .pptx files use a PowerPoint-specific tool. Trigger phrases: "presentation", "slide deck", "slides", "pitch deck", "keynote", "reveal.js", "slide design", "presentation template", "speaker notes"
Also in 3 projects that use this
GitHubSkillaccessibility-audit
Audits actual components and routes against applicable WCAG 2.2 A/AA criteria using consumer-owned design-system evidence and repository tools. Use when asked for an accessibility audit, a11y check, keyboard or focus review, contrast check, or screen-reader verification.
Also in 4 projects that use this
soilmassSkillmotion-design
Create animations and motion graphics using industry standards. Use when asked to animate UI elements, create video content, implement transitions, or build motion systems. Implements W3C Design Tokens, Material Design 3 baseline, and Lottie specification compliance.
Also in 3 projects that use this
AnthropicSkillcompetitive-analysis
Framework for building competitive landscape decks — market positioning, competitor deep-dives, comparative analysis, strategic synthesis. Use when the user asks for a competitive landscape, competitor analysis, peer comparison, market positioning assessment, strategic review, or investment memo deck. Also triggers on "who are the competitors to X", "benchmark X against peers", "build a market map", or any request to systematically evaluate competitive dynamics across an industry.
Also in 3 projects that use this
VercelSkillagent-browser
Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.
Also in 3 projects that use this
BlockSkillfrontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
Also in 5 projects that use this
Other versions37 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 37
- anthropics/knowledge-work-plugins★ 35ksame name
- cuellarfr/design-skills★ 94same name
- adityareddy-dev/deskstudio★ 43same name
- tdimino/claude-code-minoan★ 41same name
- launchapp-dev/animus-cli★ 39same name
- ArnavPuri/designskills★ 17same name
- henrique-simoes/Istara★ 15same name
- aiatelie/ai-atelie★ 9same name
- mae616/ai-template★ 9same name
- shayan-m81/layerwright★ 8same name
27 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository33 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- accessibility-reviewSkill
- art-directionSkill
- brand-identitySkill
- brand-strategySkill
- brand-voiceSkill
- color-systemSkill
- component-api-designSkill
- design-briefSkill
- design-case-studySkill
- design-discoverySkill
- design-handoffSkill
- design-system-auditSkill
- design-system-docsSkill
- design-to-codeSkill
- design-tokensSkill
- iconographySkill
- information-architectureSkill
- interface-polishSkill
- landing-page-designSkill
- layout-and-hierarchySkill
- micro-interactionsSkill
- motion-implementationSkill
- motion-languageSkill
- product-design-processSkill
- reference-researchSkill
- typography-systemSkill
- usability-testingSkill
- user-researchSkill
- ux-writingSkill
- visual-qaSkill
- wireframingSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 7 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 31 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 50
Frame the critique: Write goal, audience, stage, primary task, feedback wanted, and what is out of scope.
- Distinctive: line 61
If a tool is not connected, say so in one line and work from what you have.
- Very specific: line 66
Heuristic pass: Check each screen against Nielsen's 10 usability heuristics.
- Distinctive: line 97
Write the factor that drove the rating when it is not obvious.
- Distinctive: line 102
Every issue has three parts, in this order:
- Distinctive: line 117
Ask a question when intent is unclear: "Is the secondary nav meant to be hidden on mobile?" Log it under open questions, not as an issue.
- Distinctive: line 122
Every issue names where it is: flow step and screen name, plus region ("Checkout / Payment, order summary card") or Figma node id, or URL …
- Distinctive: line 169
Every issue rated 3 or 4, so nothing is prioritized
“Common” is measured: kept by at least 6 in 10 of the 31 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Design Critique
A critique is a structured look at a design against its goal, done by someone who is not its author. It finds problems a person would hit, ranks them, and says what to do about each one. It is not a verdict on taste. The output is a critique report that lists only issues, each pinned to a screen and region, rated 0–4, and phrased as observation, impact, suggestion, ending in a one-line verdict.
When to use
- A design is ready for review at any stage: wireframe, mid-fi, hi-fi, or shipped
- A heuristic evaluation before, or instead of, a usability test
- A flow "feels off" and the team wants specific, ranked problems
- Reviewing a competitor or a reference to learn from it
- Self-review before presenting work
Not for: watching real people use the design (use usability-testing), a
conformance audit against WCAG (use accessibility-review), or pixel comparison
against a spec (use visual-qa).
Inputs
Gather these. If one is missing, use the default in brackets.
- The design: screenshots, a Figma link, or a live URL [ask; this is required]
- Goal: what the screen or flow must achieve, and for whom [infer from the content; state the assumption at the top of the report]
- Stage: exploration, refinement, or pre-ship [infer from fidelity: gray boxes mean exploration]
- Feedback wanted: what the author wants reviewed, and what is out of scope [everything that matters at this stage]
- Constraints: platform, design system, deadlines, decisions already locked [none locked]
- Primary task to walk through [the most common task implied by the goal]
Process
- Frame the critique. Write goal, audience, stage, primary task, feedback
wanted, and what is out of scope. Stage sets depth: at exploration, critique
structure and concept only; at pre-ship, everything including craft. Model: the
"Framing" block of
templates/critique-report.md. Copy that shape. - Capture the design. One image per screen and state, named by flow step.
- Figma MCP:
get_screenshoton each frame's node id;get_metadatato list frames in a section. Loadget_design_contextonly if you need values. - Live URL: Playwright screenshots at 1440 and 390, plus the states you can reach (empty, error, loading, hover, focus).
- Screenshots: use as given; note which states are missing. If a tool is not connected, say so in one line and work from what you have. Output: an ordered list of captured screens with ids.
- Figma MCP:
- Walk the primary task. Step through it as the target person would, screen by screen. At each step ask: do I know where I am, what I can do, and what will happen? Output: the step list with every hesitation point marked.
- Heuristic pass. Check each screen against Nielsen's 10 usability heuristics.
Model:
references/heuristics.md, which lists what to look for and common violations per heuristic. Output: issues tagged H1–H10. - Hierarchy pass. Squint test each screen: does the most important element read first? Is there one primary action per view? Output: issues tagged "Hierarchy".
- Clarity pass. Labels, copy, icons without text, jargon, ambiguous states. Output: issues tagged "Clarity".
- Consistency pass. Same thing looks and behaves the same across screens and matches the design system and platform conventions. Output: issues tagged "Consistency".
- Craft pass (refinement and pre-ship only). Alignment, off-scale spacing, contrast, truncation, missing states, focus styles. Output: issues tagged "Craft".
- Rate and phrase. Merge duplicates, rate each issue 0–4, phrase as observation, impact, suggestion. Output: the issue list, sorted by severity.
- Write the verdict. "Ready", or "N blocking issues" where blocking means severity 3–4. Output: the report.
Standards
Severity (Nielsen's 0–4 scale)
| Rating | Meaning | Blocking? | Action |
| 4 | Usability catastrophe: people cannot complete the task, or lose data or money | Yes | Fix before release |
| 3 | Major: people are slowed or confused often, or some fail | Yes | Fix before release, high priority |
| 2 | Minor: noticeable friction, people recover on their own | No | Fix soon |
| 1 | Cosmetic: noticed by few, no effect on completion | No | Fix if time allows |
| 0 | Not a usability problem | n/a | Do not report |
Nielsen rates severity from three factors: frequency (how many people hit it), impact (how hard it is to overcome), and persistence (once, or every time). Write the factor that drove the rating when it is not obvious. Do not inflate: a report with ten severity-4s gets ignored.
Feedback phrasing
Every issue has three parts, in this order:
- Observation: what is on screen, factually. "The 'Continue' button is below the fold at 390px width."
- Impact: what it does to the person or the goal. "On mobile, people who finish the form see no way forward and may think the form is broken."
- Suggestion: one concrete direction, not a redesign. "Make the button sticky at the bottom of the viewport, or reduce the form to fit."
Rules:
- Tie impact to the goal or the person, never to taste. "I don't like the blue" is not an issue; "the link blue and the error red are hard to tell apart for people with protanopia" is.
- One issue per entry. If an entry says "also", split it.
- Suggestions are optional directions, not specs. The author owns the fix.
- Ask a question when intent is unclear: "Is the secondary nav meant to be hidden on mobile?" Log it under open questions, not as an issue.
Location
Every issue names where it is: flow step and screen name, plus region ("Checkout / Payment, order summary card") or Figma node id, or URL and breakpoint. An issue without a location cannot be fixed or verified.
Depth by stage
| Stage | Critique | Skip |
| Exploration (lo-fi) | Concept fit, task flow, structure, missing states | Visual craft, copy polish |
| Refinement (mid/hi-fi) | All heuristics, hierarchy, clarity, consistency | Pixel-level craft |
| Pre-ship (hi-fi or live) | Everything, including craft and edge cases | Nothing |
Output
A critique report using
templates/critique-report.md: framing, the screens
reviewed, the issue table (failures only, sorted by severity, each with location,
tag, severity, observation, impact, suggestion), open questions, and a one-line
verdict. Do not list what works; the report is a to-do list.
Verify
Done means every check passes:
- Framing states goal, stage, primary task, and feedback wanted
- Every screen and state in scope was captured and walked
- Every issue has a location specific enough to find in under 10 seconds
- Every issue has observation, impact, and suggestion; impact names a person or the goal, not a preference
- Every issue has a severity 1–4 and a tag (H1–H10, Hierarchy, Clarity, Consistency, Craft)
- No duplicates; no issue contains "also"
- Depth matches the stage (no pixel nits on a wireframe)
- The report ends with one line:
ReadyorN blocking issues(count of 3s and 4s)
For an independent read, delegate to the design-critic subagent with the captured
screens and framing; merge its findings with yours and keep the higher severity on
conflicts. If the design is pre-ship, also delegate to the accessibility-auditor
subagent, and to the copy-reviewer subagent when clarity issues cluster in copy.
Anti-patterns
- Opening with praise to soften the issues, or listing strengths as filler
- "Make it pop", "feels cluttered", "not intuitive" with no observation behind it
- Redesigning the screen inside the critique instead of naming the problem
- Taste presented as a usability issue
- Every issue rated 3 or 4, so nothing is prioritized
- Critiquing color and type on a gray wireframe
- Reviewing only the happy path; no empty, error, loading, or long-content states
- Issues without locations ("somewhere in settings the labels are inconsistent")
- Citing a heuristic by number without explaining how the design violates it
Related skills
- Feeds from:
wireframing,layout-and-hierarchy,interface-polish, or any shipped screen - Leads to:
usability-testing(confirm the severity-3+ issues with real people),accessibility-review,ux-writing(copy issues),interface-polish(craft issues)
References
From REFERENCE-BANK.md:
- Nielsen Norman Group: the 10 usability heuristics (Nielsen, 1994), the severity rating method, and "How to conduct a heuristic evaluation" (3–5 evaluators find most issues; one finds about 35%).
- Laws of UX: named principles (Hick's, Fitts's, Jakob's Law) to explain impact.
- Refactoring UI: vocabulary for hierarchy and craft issues.
- Mobbin and Page Flows: how shipped products solve the same step, to ground a suggestion in precedent.
- Good UI: evidence from A/B tests when a suggestion needs support.
From FIBO.md:
- Read-only reviewer (
component-reviewer): the report shape this skill copies: failures only, each with a location, ending in a one-line verdict.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

