aesthetic-usability — Claude Code skill: what it does, install
Applies the Aesthetic-Usability Effect when visual polish affects perceived ease of use and trust. Use it to diagnose functional designs that still make a poor first impression.
npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a claude-codeWhat aesthetic-usability does
This skill applies the Aesthetic-Usability Effect: people can perceive a polished, consistent interface as easier to use before they interact with it. It reviews spacing, alignment, type scale, and the visual weight of related buttons, links, and icons.
It also brings the same scrutiny to loading, error, and empty states, first-impression screens, and design-system components. In payment flows, health data, and legal content, visual quality can affect whether someone proceeds.
Polish does not fix weak information architecture or interaction design. Treat that as a reason to test usability separately, because aesthetic tolerance has limits.
What it helps with
- audit visual inconsistencies before launch
- diagnose why a functional screen feels untrustworthy
- review error and empty states for visual quality
- align spacing, grid, and typography
- separate surface polish from usability issues
Example prompts for the agent
- Review this screen through the Aesthetic-Usability Effect and flag visual inconsistencies.
- Explain why this error state feels untrustworthy even though the flow works.
- Audit the spacing, alignment, and type scale before launch.
How to install aesthetic-usability
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a claude-code2Manually: put the files in place
~/.claude/skills/aesthetic-usability/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/aesthetic-usability/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a codex2Manually: put the files in place
.agents/skills/aesthetic-usability/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a cursor2Manually: put the files in place
.cursor/skills/aesthetic-usability/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills aesthetic-usability2Manually: put the files in place
.github/skills/aesthetic-usability/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path ui-design/skills/aesthetic-usabilityManually: put the files in place
.devin/skills/aesthetic-usability/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about aesthetic-usability
How do I install aesthetic-usability in Claude Code?
Run npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a claude-code, then run npx skills add Owl-Listener/designer-skills --skill aesthetic-usability -a claude-code again.
What does aesthetic-usability do?
It helps assess how visual consistency and polish shape perceived usability and trust. The skill does not replace usability testing.
How is aesthetic-usability different from interfaces-that-feel?
This skill focuses on the link between visual quality and perceived usability. For emotional resonance in interfaces, use interfaces-that-feel from interaction-design.
Source text
SKILL.md · MIT
--- name: aesthetic-usability description: Apply the Aesthetic-Usability Effect — polished, consistent interfaces are perceived as more usable and forgive minor friction. Use when justifying visual polish or diagnosing why a functional design tests badly. For emotional resonance specifically, use `interfaces-that-feel` (interaction-design). --- # Aesthetic-Usability Effect You are an expert in the relationship between visual quality and perceived usability. ## What You Do You apply the Aesthetic-Usability Effect to ensure visual consistency and polish translate into user trust and perceived quality — without masking genuine usability problems. ## The Principle Users perceive aesthetically pleasing interfaces as easier to use, even before interacting with them. This is not about decoration — it is about **consistency as a signal of quality**: - Consistent spacing, alignment, and type scale signals that the product is well-considered - Visual noise or inconsistency makes users doubt the reliability of the system - A polished surface creates tolerance: users forgive minor friction in beautiful UIs more readily ## Where It Applies - **First impressions**: onboarding, landing pages, empty states — users form opinions before first interaction - **Error states**: a well-designed error screen reads as trustworthy; a rough one reads as broken - **Trust-critical contexts**: payment flows, health data, legal content — aesthetics directly affect willingness to proceed - **Design systems**: consistent component usage signals quality across the entire product ## The Risk The effect can mask usability problems. A beautiful interface that is hard to use will eventually frustrate users — aesthetic tolerance has limits. Use it to lower the bar for first impressions, not to substitute for sound information architecture or interaction design. ## Applying It 1. Establish and enforce a consistent spacing and type scale — irregularity reads as carelessness 2. Align to grid; misaligned elements signal low craft even if functional 3. Maintain visual weight consistency across similar actions (buttons, links, icons) 4. Design error, empty, and loading states with the same care as primary flows 5. Audit for visual inconsistency before launch — a single rough screen can lower the perceived quality of surrounding screens ## Best Practices - Consistency is the most reliable aesthetic signal — prioritize it over novelty - Test perceived quality with users who haven't seen the design before - Don't confuse visual complexity with quality; restrained, deliberate design reads as more polished - Pair aesthetic investment with usability testing — polish should not substitute for structural clarity
© Owl-Listener · MIT · Owl-Listener/designer-skills