design-everyday-things
Apply foundational design principles: affordances, signifiers, constraints, feedback, and conceptual models
Install / Use
npx skills add wondelai/skills --skill design-everyday-thingsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of design-everyday-things
design-everyday-things scores 90/100 on our quality scale, 1346th of 4,698 Development & Engineering skills we index (top 29%).
Its SKILL.md is 15 KB long, well organised into 23 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 2,248 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so design-everyday-things is actively maintained.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
design-everyday-things compared with similar skills
All 4 of these similar skills score higher than design-everyday-things; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| design-everyday-things (this skill)by wondelai | 90 | 2.2k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install design-everyday-things?
- Run
npx skills add wondelai/skills --skill design-everyday-things. The install tabs above show the steps for each supported agent. - Which AI agents does design-everyday-things work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is design-everyday-things safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is design-everyday-things still maintained?
- The repository was last updated about 2 months ago, so design-everyday-things is actively maintained.
Skill content
View source on GitHubname: design-everyday-things description: 'Apply foundational design principles: affordances, signifiers, constraints, feedback, and conceptual models. Use when the user mentions "why is this confusing", "affordance", "error prevention", "discoverability", "human-centered design", "mental model", "mapping", "seven stages of action", "users keep making mistakes", "this is unintuitive", or "people cant figure out how to use it". Also trigger when reducing product complexity or feature creep. Covers the gulfs of execution and evaluation. For usability scoring, see ux-heuristics. For iOS-specific patterns, see ios-hig-design.' license: MIT metadata: author: wondelai version: "1.4.0"
Design of Everyday Things Framework
Foundational design principles for creating products that are intuitive, discoverable, and understandable. The "bible of UX" — applicable to physical products, software, and any human-designed system.
Core Principle
Good design is actually a lot harder to notice than poor design, in part because good designs fit our needs so well that the design is invisible. When something fails, users blame themselves — but the fault is almost always in the design. Great design bridges the gap between what people want to do and what the product allows: it is discoverable (you can figure out what to do) and understandable (you can figure out what happened).
Scoring
Goal: 10/10. Score 2 points per satisfied row of the Quick Diagnostic (5 rows = discoverability, evaluation, error recovery, mapping, constraints). Bands: 9-10 = users act without instructions, understand every outcome, and recover from any error; 5-6 = one gulf or error path is broken; <=3 = users must consult a manual or routinely blame themselves. Report the current score and the diagnostic rows failing it.
The Two Gulfs
Every interaction with a product requires bridging two gulfs:
USER PRODUCT
│ │
├──── Gulf of Execution ────────────────→│
│ "How do I do what I want?" │
│ │
│←──── Gulf of Evaluation ──────────────┤
│ "What happened? Did it work?" │
Gulf of Execution
The gap between what users want to do and what the product lets them do. Users ask: What can I do here? Which control do I use?
Bridge with: clear signifiers, natural mappings, constraints, familiar conceptual models.
Gulf of Evaluation
The gap between what the product did and what users understand happened. Users ask: What happened? Did it work? What state is the system in?
Bridge with: immediate visible feedback, clear system-state indicators, meaningful error messages, progress indicators.
Design goal: Make both gulfs as narrow as possible — action and understanding should be immediate.
See: references/two-gulfs.md for gulf analysis exercises.
Seven Fundamental Design Principles
1. Discoverability
Definition: Can users figure out what actions are possible and how to perform them? Its five components — affordances, signifiers, constraints, mappings, feedback — are detailed below.
Test: Put a new user in front of your product. If they can't figure out what to do within 10 seconds, discoverability is broken.
Anti-pattern: "The user manual explains it." If users need a manual, the design failed.
2. Affordances
Definition: The relationship between an object's properties and a user's capabilities that determines how the object could be used.
Key insight: Affordances exist whether or not they are perceived — what matters for design is perceived affordance.
| Type | Definition | Example | |------|------------|---------| | Real | Physical capability exists | A button affords pressing | | Perceived | User believes capability exists | A raised area looks clickable | | Hidden | Exists but isn't obvious | Right-click context menu | | False | Appears to afford action but doesn't | Decorative element that looks clickable | | Anti-affordance | Prevents action | A barrier that blocks movement |
Digital applications:
| Element | Affordance | How to Signal | |---------|------------|---------------| | Button | Clicking/tapping | Raised, colored, shadow, hover state | | Text field | Text input | Border, placeholder text, label | | Scroll area | Scrolling | Scroll bar, fade at edge, partial content |
Common failures: flat design erasing perceived affordances (button or label?), too-small touch targets, interactive and decorative elements that look identical.
See: references/affordances.md for affordance design patterns.
3. Signifiers
Definition: Signals that communicate where the action should take place. Affordances determine what you CAN do; signifiers show you WHERE and HOW.
| Type | Definition | Example | |------|------------|---------| | Deliberate | Designed to communicate | "Push" label on door, placeholder text | | Accidental | Unintentional but informative | Worn path in grass (people walk here) | | Social | Other people's behavior | Line of people indicates entrance |
Digital signifiers:
| Signifier | What It Communicates | Example | |-----------|---------------------|---------| | Cursor change + hover state | This is interactive | Pointer → hand on links; button color change | | Icons + labels | Function of the element | Magnifying glass = search; "Submit", "Cancel" | | Color + position | Status, category, hierarchy | Red = error, green = success; close button top-right |
Design rule: When in doubt, add a signifier — better to over-communicate than leave users guessing.
See: references/signifiers.md when deciding which signifier to add to an unclear control.
4. Mappings
Definition: The relationship between controls and their effects. Natural mapping means the spatial layout of controls matches the layout of what they control.
| Mapping Quality | Example | Why It Works/Fails | |-----------------|---------|-------------------| | Natural | Volume slider (up = louder) | Matches mental model | | Poor | Light switch panel | No spatial correspondence to lights | | Poor | Stovetop knobs in a row | Layout doesn't match burner positions |
Digital principles: controls near what they affect, layout mirroring content, direction matching expectation (scroll down = content moves up), related controls grouped.
| Technique | How It Works | Example | |-----------|-------------|---------| | Proximity | Control near target | Edit button next to content | | Spatial | Layout mirrors real world | Map controls match compass directions | | Cultural | Follows conventions | Red = stop/danger, green = go/safe | | Sequential | Follows natural order | Steps 1, 2, 3 left to right (or top to bottom) |
See: references/mappings.md for mapping analysis exercises.
5. Constraints
Definition: Limiting the possible actions to prevent errors.
| Type | Mechanism | Example | |------|-----------|---------| | Physical | Shape/size prevents wrong action | USB plug only fits one way | | Cultural | Social norms guide behavior | Red means stop, green means go | | Semantic | Meaning restricts options | A rearview mirror only makes sense facing backward | | Logical | Logic limits choices | Only one hole left for the last screw |
Digital constraints:
| Constraint | Implementation | Example | |------------|---------------|---------| | Input validation | Restrict what can be entered | Date picker vs. free text | | Disabled states | Gray out unavailable options | "Submit" disabled until form valid | | Forced sequence + undo | Steps in order; allow reversal | Wizard with locked steps; Gmail "Undo send" |
Design rule: Every constraint you add is one less error the user can make — make wrong actions impossible rather than punishing them.
See: references/constraints.md for constraint design patterns.
6. Feedback
Definition: Communicating the results of an action back to the user. Feedback must be immediate (within 0.1s for direct manipulation), informative, appropriately dosed, and non-intrusive.
| Type | When to Use | Example | |------|-------------|---------| | Visual | Most actions | Button press animation, color change, checkmark | | Auditory | Important events, confirmations | Success chime, error sound | | Haptic | Touch devices, confirmation | Vibration on key press | | Progress | Long operations | Progress bar, spinner, skeleton screen |
Digital feedback patterns:
| Situation | Feedback Needed | Example | |-----------|----------------|---------| | Form submission | Success/error message | "Saved!" toast or inline error | | Loading | Progress indicator | Spinner, skeleton screen, percentage | | Error | What went wrong + how to fix | "Invalid email. Please check format." |
Response times: 0.1s feels instantaneous; 1s is a noticeable delay (change cursor); 10s loses attention (show progress bar); over 10s users leave (show percentage, allow backgrounding).
Common failures: no feedback (did my click register?), delayed feedback (feels broken), unclear feedback, alert overload.
See: references/feedback.md when an action gives no clear result and you need the right feedback type and timing.
7. Conceptual Models
Definition: The user's mental model of how a product works.
| Model | Held By | Description | |-------|---------|-------------| | Design model | Designer | How the designer thinks it works | | User's model | User | How the user thinks it works | | System image | Product | What the product actually communicates |
Goal: The user's model should match the design model; the system image is the only bridge. Matching models let users predict outcomes and recover from errors; mismatches breed confusion, self-blame, and support calls.
Example (thermostat): design model — set a temperature, the system maintains it; common user model — higher setting heats faster (wrong), so users crank it to 90°F.
Build correct models with: familiar metaphors (desktop, trash), visible system state, clear feedback, consistent behavior, progressive disclosure.
See: references/conceptual-models.md when the user's model diverges from how the product works. For fully worked teardowns (door handles, thermostats, digital products), see references/case-studies.md.
Human Error
Norman's key insight: there is no such thing as "human error" — only bad design. When someone errs, look for the design flaw, not the person's flaw.
Types of Errors
Slips — correct intention, wrong action:
| Slip Type | Cause | Example | Design Fix | |-----------|-------|---------|------------| | Action slip | Wrong action on right target | Click "Delete" instead of "Edit" | Separate destructive actions | | Memory lapse | Forget step in sequence | Forget attachment after writing "attached" | Gmail's attachment reminder | | Mode error | Right action, wrong mode | Type in caps lock | Show mode state clearly | | Capture error | Habit overrides intention | Drive to old office on autopilot | Interrupt at decision points |
Mistakes — wrong intention, executed correctly:
| Mistake Type | Cause | Example | Design Fix | |-------------|-------|---------|------------| | Rule-based | Apply wrong rule | Use formula for wrong situation | Provide context, confirm | | Knowledge-based | Incomplete/wrong mental model | Misunderstand how system works | Better conceptual model | | Memory lapse | Forget goal or plan | Forget why you opened the fr
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
