ux-audit
Skill48 starsChanged 17 days agoMITView on GitHub
Use when a page or component needs a structured UX audit — quick scan applies 6 Krug-inspired usability checks; deep audit covers 15 design dimensions with Jobs/Ive philosophy
26 other projects use a version of this.
Adopted by
Most recently taken up by
- thensls/nsls-builder-toolkittheir own version, first seen Nov 8, 2026
- naman10parikh/pennytheir own version, first seen Nov 8, 2026
- naman10parikh/wikimemtheir own version, first seen Nov 8, 2026
- lobehub/lobehubtheir own version, first seen Nov 5, 2026
- AhmedAbdelfattah0/AI-Skillstheir own version, first seen Nov 4, 2026
- naman10parikh/turbotheir own version, first seen Oct 25, 2026
Used with
Projects with it also use ecosystem-reference, fractal-delegation and 10 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.
naman10parikhSkillecosystem-reference
Quick-access directory of Claude Code ecosystem repos, skills, plugins, MCPs, and patterns. Use when improving the harness.
Also in 5 projects that use this
naman10parikhSkillfractal-delegation
Also in 5 projects that use this
KirchliveSkillskill-routing
Decides which of the installed skills a task needs and loads them before the work starts. This skill should be used at the beginning of any multi-step task — build, fix, refactor, migrate, review, plan, release, research, write, design, video — and again at every phase change, after context compaction, and when work moves into a different part of the codebase. Use it for requests like "let's build X", "fix this bug", "refactor Y", "plan the migration", "review this", and also when the user asks which skill applies, why a skill did not fire, or asks to check what is available.
Also in 5 projects that use this
sublimotionSkillagent-runtime
Launch and manage detached agent runs on EKS via the agent-runner CLI. Use when the user says "launch an agent run", "agent runtime", "agent-runner", "run this spec on the cluster", "check run status", "agent run logs", or "stop a run". Do NOT use for writing the agent-runner code itself (edit the sibling ../agent-runner repo), Terraform of the foundation (use terraform-automation), or GPU serving deployments (use infra-deployer).
Also in 5 projects that use this
GoZippySkillrepo-scout
Also in 5 projects that use this
BenjaminGSkillharness-review
Turn one PR's review comments into harness fixes — classify each cause by the most solid place it can live (codebase, lint, rules, skill), then draft the fixes in a separate PR.
Also in 5 projects that use this
- +6 more from naman10parikh
Other versions26 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 26
- lobehub/lobe-chat★ 84ksame name
- lobehub/lobehub★ 84ksame name
- thedesignproject/agent-skills★ 88same name
- EliaAlberti/ux-audit-skill★ 17same name
- kevin-burns/claude-skills★ 10same name
- naman10parikh/agentgrid★ 9same name
- naman10parikh/wikimem★ 8same name
- AhmedAbdelfattah0/AI-Skills★ 4same name
- paulunemoon/ux-audit-skill★ 4same name
- AhmedMerza/agent-skills★ 2same name
16 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 repository111 other files it gives its agents.
- AGENTS.mdAGENTS.md
- COPILOT-INSTRUCTIONS.mdCopilot instructions
- .github/copilot-instructions.mdCopilot instructions
- ai-visibilitySkill
- content-strategySkill
- seoSkill
- actions-debuggingSkill
- agentic-engineeringSkill
- autopilot-patternsSkill
- background-agentSkill
- context-primeSkill
- copilot-memorySkill
- cross-session-memorySkill
- ecosystem-intakeSkill
- fleet-parallelSkill
- github-code-searchSkill
- github-codespaces-efficiencySkill
- github-issue-triageSkill
- github-pr-workflowSkill
- ide-switchingSkill
- knowledge-curatorSkill
- mcp-builderSkill
- mcp-ecosystemSkill
- multi-model-strategySkill
- plan-mode-masterySkill
- scope-guardSkill
- session-managementSkill
- stack-detectorSkill
- sub-agent-sandboxingSkill
- task-intake-routerSkill
- team-plannerSkill
- token-cost-optimizerSkill
- api-and-interface-designSkill
- code-reviewSkill
- context-engineeringSkill
- cpp-debuggingSkill
- deprecation-and-migrationSkill
- diagnoseSkill
- fix-build-errorsSkill
- fix-github-issueSkill
- implementSkill
- improve-codebase-architectureSkill
- nestjs-prismaSkill
- nextjs-prismaSkill
- performance-optimizationSkill
- pr-multi-perspective-reviewSkill
- prototypeSkill
- react-vitestSkill
- receiving-code-reviewSkill
- refactor-cleanSkill
- reviewSkill
- skill-creatorSkill
- source-driven-developmentSkill
- spec-driven-developmentSkill
- systematic-debuggingSkill
- tdd-workflowSkill
- zoom-outSkill
- add-to-changelogSkill
- api-documentationSkill
- architecture-decisionsSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
17 rules. 0 are common, 15 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 23 edited versions we read keep these.
15
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Run a structured usability review based on Steve Krug's *Don't Make Me Think*.
- Distinctive: line 14
Use it to inspect page structure, copy, navigation, and interaction friction before or alongside design review.
- Distinctive: line 20
Before a design review or frontend handoff
- Distinctive: line 21
When users report confusion but the failure mode is still unclear
- Distinctive: line 22
When navigation, headings, or calls to action feel noisy or ambiguous
- Distinctive: line 46
Before implementation starts, write a short contract for the screen so the later audit has something concrete to enforce.
- Distinctive: line 66
Use the existing audit checks as the contract's enforcement points:
- Distinctive: line 74
Run all six checks in sequence.
- Very specific: line 158
If runtime inspection is needed, pair this skill with browser-devtools.
- Distinctive: line 162
Default to a short human-readable report:
- Distinctive: line 183
If another workflow needs structured output, you may additionally emit JSON, but human-readable findings remain the primary deliverable.
- Distinctive: line 190
Do not accept vague self-congratulation as a design decision.
- Distinctive: line 197
Prefer concrete evidence ("two CTAs compete above the fold") over taste-based critique
- Distinctive: line 203
Use for major redesigns, premium quality assessment, or when the quick scan surfaces systemic issues.
- Distinctive: line 234
The test: Remove until it breaks. Then add back the last thing.
- Distinctive: line 238
After completing all 15 dimensions, compile a phased plan before making any changes:
- Very specific: line 264
If the audit surfaces a control that is broken, dead, or behaves incorrectly, record it as a UX-impacting finding but hand off functional …
“Common” is measured: kept by at least 6 in 10 of the 23 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
UX Audit
Run a structured usability review based on Steve Krug's Don't Make Me Think. Use it to inspect page structure, copy, navigation, and interaction friction before or alongside design review.
When to Use
- UI를 만들기 전에 화면의 목적과 품질 기준을 먼저 못 박아야 할 때
- Before a design review or frontend handoff
- When users report confusion but the failure mode is still unclear
- When navigation, headings, or calls to action feel noisy or ambiguous
- During UI quality sweeps after major layout or copy changes
When NOT to Use
| Instead of ux-audit | Use |
| Accessibility conformance or ARIA debugging | browser-devtools |
| End-to-end flow automation | e2e-testing |
| Broken or non-functional controls discovered during a UX pass | flag in the audit, then hand off to e2e-testing for functional verification |
| Performance bottleneck analysis | browser-devtools or performance-optimization |
| Pure visual polish critique | manual design review |
Audit Modes
Choose the depth of review based on what you need:
| Mode | Checks | Best for |
| Quick scan (default) | 6 Krug usability checks | Navigation/copy confusion, pre-handoff spot checks |
| Deep audit | 15-dimension Jobs/Ive framework | Major redesigns, premium quality bar, comprehensive UI review |
Design Contract — Before Building
Before implementation starts, write a short contract for the screen so the later audit has something concrete to enforce.
Capture only three things:
- Purpose — one sentence for what this screen is for
- Primary action — the one action that must win attention first
- Forbidden defaults/patterns — shortcuts the screen is not allowed to fall back to
Keep it short:
## Design Contract: [screen]
- Purpose: [one sentence]
- Primary action: [the main CTA or task]
- Forbidden defaults:
- [generic welcome copy / dashboard filler / placeholder layout / competing CTAs / etc.]Use the existing audit checks as the contract's enforcement points:
- Trunk Test / Page Area Test verify that purpose is obvious
- 3-Second Scan verifies that the primary action wins quickly
- Happy Talk Detection verifies that forbidden generic copy did not creep back in
The 6 Usability Checks
Run all six checks in sequence. A page with repeated failures across these categories needs structural revision, not copy-only cleanup.
1. Trunk Test
"If I dropped you in the middle of this page with no context, where are you?"
Check:
- Site or product identity is visible quickly
- A page-level heading makes the purpose obvious
- Navigation exists and is easy to locate
- Current location is indicated with active nav or breadcrumbs
2. 3-Second Scan
"What does this page do?"
Check:
- The primary action or value proposition is visible without hunting
- Heading hierarchy is scannable
- One primary call to action clearly wins attention
3. Page Area Test
"Can you tell what each part of this page is for?"
Check:
- Major regions such as header, main content, sidebar, and footer are distinct
- Headings introduce real content instead of stacking without explanation
- Section purpose is clear before reading full paragraphs
4. Happy Talk Detection
"Is the page making me read obvious or low-value copy?"
Look for:
- Generic welcome copy that says little
- Repetitive marketing filler above the real action
- Links or buttons with vague labels like
Click hereorLearn more
5. Mindless Choice Audit
"Does every click require extra thought?"
Check:
- Links describe destinations clearly
- Form fields use real labels, not placeholder-only hints
- Options are named so users can choose quickly
6. Goodwill Reservoir
"Is the page wasting the user's time or patience?"
Check:
- Body text is comfortably readable
- Errors explain how to recover
- Media or overlays do not interrupt the task unexpectedly
Hard Fail Signals
Escalate findings when any of these appear:
- Placeholder text used as the only field label
- Missing, generic, or low-signal primary heading
- Floating headings with no supporting content
- Visited and unvisited links are visually indistinguishable
- Body text is too small to read comfortably
Suggested Workflow
- Before building, write the Design Contract: purpose, primary action, forbidden defaults/patterns.
- Choose your audit mode: Quick Scan (6 checks, default) or Deep Audit (15 dimensions) — see Audit Modes table above.
- Inspect the live page or rendered component
- Record evidence for each check (Quick Scan) or each dimension (Deep Audit)
- Mark each check/dimension as pass, concern, or fail
- Separate structural issues from copy polish
- Prioritize fixes that reduce confusion on the main user path
If runtime inspection is needed, pair this skill with browser-devtools.
Output Format — Quick Scan
Default to a short human-readable report:
## UX Audit: [page or component]
- **Trunk Test**: Pass | Concern | Fail - [reason]
- **3-Second Scan**: Pass | Concern | Fail - [reason]
- **Page Area Test**: Pass | Concern | Fail - [reason]
- **Happy Talk**: Pass | Concern | Fail - [reason]
- **Mindless Choice**: Pass | Concern | Fail - [reason]
- **Goodwill Reservoir**: Pass | Concern | Fail - [reason]
**Hard Fail Signals**
- [issue or "None"]
**Top Fixes**
1. [highest-priority change]
2. [next change]
3. [next change]If another workflow needs structured output, you may additionally emit JSON, but human-readable findings remain the primary deliverable.
For Deep Audit output, see the Phased Plan Output template in the Deep Audit section below.
Finish Gate
Do not accept vague self-congratulation as a design decision. Terms like "clean," "modern," "intuitive," or "premium" are non-answers unless they resolve into specific choices visible on the screen.
Reject the screen if its copy and layout feel generic enough that they could be bolted onto a completely unrelated product without anyone noticing. Passing requires product-specific purpose, language, and emphasis — not interchangeable SaaS wallpaper.
Tips
- Judge the page from a first-visit perspective, not from implementation knowledge
- Prefer concrete evidence ("two CTAs compete above the fold") over taste-based critique
- Fix structural confusion before refining tone or visual polish
- Re-run the audit after major IA, copy, or navigation changes
Deep Audit — Jobs/Ive 15 Dimensions
Use for major redesigns, premium quality assessment, or when the quick scan surfaces systemic issues. Review every screen across all 15 dimensions before writing any recommendations.
The 15 Dimensions
| Dimension | Key Questions |
| Visual Hierarchy | Does the eye land where it should? Most important = most prominent? Understandable in 2 seconds? |
| Spacing & Rhythm | Whitespace consistent and intentional? Elements breathe or cramped? Vertical rhythm harmonious? |
| Typography | Clear size hierarchy? Too many competing weights/sizes? Calm or chaotic? |
| Color | Used with restraint and purpose? Guides attention or scatters it? Sufficient contrast? |
| Alignment & Grid | Consistent grid? Anything off by 1–2px? Every element locked into layout? |
| Components | Similar elements styled identically? Interactive elements obviously interactive? All states covered? |
| Iconography | Consistent style, weight, size? From one cohesive set or mixed? Support meaning or just decorate? |
| Motion | Transitions natural and purposeful? Motion that exists for no reason? Feels responsive? |
| Empty States | Every screen with no data — intentional or broken? User guided toward first action? |
| Loading States | Skeletons/spinners consistent? App feels alive while waiting or frozen? |
| Error States | Styled consistently? Helpful and clear or hostile and technical? |
| Dark Mode | Actually designed or just inverted? Tokens, shadows, contrast hold up? |
| Density | Anything removable without losing meaning? Redundant elements? Every element earning its place? |
| Responsiveness | Works at mobile/tablet/desktop? Touch targets sized for thumbs? Adapts fluidly, not just at breakpoints? |
| Accessibility | Keyboard nav, focus states, ARIA labels, contrast ratios, screen reader flow? |
Jobs Filter — Apply to Every Element
For each screen element, ask:
- "Would a user need to be told this exists?" → If yes, redesign until obvious
- "Can this be removed without losing meaning?" → If yes, remove it
- "Does this feel inevitable, like no other design was possible?" → If no, it is not done
- "Is this detail as refined as the details users will never see?" → The back of the fence must be painted too
The test: Remove until it breaks. Then add back the last thing.
Phased Plan Output
After completing all 15 dimensions, compile a phased plan before making any changes:
DEEP AUDIT RESULTS:
Overall Assessment: [1–2 sentences on current state]
PHASE 1 — Critical (hierarchy, usability, responsiveness issues that actively hurt UX)
- [Screen/Component]: [what's wrong] → [what it should be] → [why this matters]
PHASE 2 — Refinement (spacing, typography, color, alignment that elevate quality)
- [Screen/Component]: [what's wrong] → [what it should be] → [why this matters]
PHASE 3 — Polish (micro-interactions, empty/loading/error states, dark mode, subtle details)
- [Screen/Component]: [what's wrong] → [what it should be] → [why this matters]
DESIGN SYSTEM UPDATES:
- [New tokens, colors, spacing, or component changes required]Do not implement until the plan is approved. Execute phase by phase, presenting results before advancing.
Scope Discipline
Deep audit covers visual design, layout, spacing, typography, color, interaction, motion, and accessibility. It does not touch application logic, state management, API calls, or feature behavior. If a design improvement would require a functional change, flag it rather than implementing it.
If the audit surfaces a control that is broken, dead, or behaves incorrectly, record it as a UX-impacting finding but hand off functional verification to e2e-testing. ux-audit diagnoses quality and clarity of the experience; it does not become the functional debugging workflow.
See Also
browser-devtools— inspect runtime DOM, network, and accessibility statee2e-testing— automate critical user journeys after the UX issues are understood
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.

