Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
dirnbauer avatar

Microinteractions

  • 6 installs
  • 33 repo stars
  • Updated July 27, 2026
  • dirnbauer/webconsulting-skills

This is a copy of microinteractions by wondelai - installs and ranking accrue to the original listing.

Helps with ai & agent building tasks.

About

microinteractions is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.

  • microinteractions
  • AI & Agent Building
  • AI-coding skill

Microinteractions by the numbers

  • 6 all-time installs (skills.sh)
  • Data as of Jul 29, 2026 (Skillselion catalog sync)
npx skills add https://github.com/dirnbauer/webconsulting-skills --skill microinteractions

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs6
repo stars33
Last updatedJuly 27, 2026
Repositorydirnbauer/webconsulting-skills

What it does

Helps with ai & agent building tasks.

Files

SKILL.mdMarkdownGitHub ↗

Microinteractions Framework

Design the tiny, contained product moments users touch every day -- toggles, password fields, loading indicators, pull-to-refresh, like buttons. Based on Dan Saffer's four-part structure (Trigger, Rules, Feedback, Loops & Modes), this framework turns invisible details into the polish that separates forgettable products from beloved ones.

Core Principle

The difference between a product you tolerate and a product you love is almost always in the microinteractions. A microinteraction is a contained moment built around a single use case -- changing a setting, syncing data, picking a password -- so small that users rarely think about it consciously, but they feel it. Every microinteraction follows the same four-part structure: a Trigger initiates it, Rules determine what happens, Feedback shows what is happening, and Loops & Modes define its long-term behavior.

Scoring

Goal: 10/10. Rate microinteractions 0-10 against the principles below: a 10/10 gives every interactive moment a deliberate trigger, clear rules, immediate feedback, and thoughtful loop/mode behavior. Always state the current score and the specific improvements needed to reach 10/10.

The Microinteraction Structure

Six areas of focus for designing world-class microinteractions:

1. Triggers

Core concept: The trigger initiates a microinteraction -- manual (tap, click, swipe, voice command) or system-initiated (time, location, incoming data, error state). It is the front door of every microinteraction.

Why it works: Without a clear trigger, users cannot discover or initiate the interaction, and the product cannot respond to changing conditions. Well-designed triggers make functionality discoverable and set accurate expectations.

Key insights:

  • A trigger must communicate three things: that it exists, what it does, and what state it is in
  • Match trigger prominence to action importance -- high-stakes actions need prominent triggers
  • Pair invisible triggers (gestures, shake, proximity) with a visible alternative for discoverability
  • Make trigger states -- default, hover, active, disabled, loading -- visually distinct

Product applications:

ContextApplicationExample
Toggle controlsManual trigger with binary stateiOS Wi-Fi switch: tap to toggle, position shows state
Pull-to-refreshHidden gesture with visible affordancePull past threshold triggers refresh animation
System alertsSystem trigger on condition metLow battery notification at 20% threshold

Ethical boundary: Never hide critical triggers behind gestures or invisible interactions without a visible fallback.

See: references/trigger-design.md for trigger affordances, states, placement, and reducing trigger complexity.

2. Rules

Core concept: Rules define what happens once a microinteraction is triggered -- the sequence of events, constraints, processing, and ending. Users never see rules directly, but they feel when rules are wrong.

Why it works: Rules create the mental model users build about how the interaction works. Consistent rules that match expectations feel natural; violations -- a toggle that does not toggle, a slider that jumps in value -- destroy trust.

Key insights:

  • Define the goal of the microinteraction first, then derive rules from it
  • Match existing mental models and platform conventions
  • Constrain inputs to prevent errors: limit character counts, set value ranges, enforce formats
  • Handle edge cases explicitly: zero, maximum, repeated triggers, interruption

Product applications:

ContextApplicationExample
Password strengthRules evaluate input in real-timeMeter updates as user types; color shifts red to green
Character counterRule constrains and shows remainingTwitter/X: counter decreases, turns red at limit
Undo actionRule sets time window for reversalGmail "Undo send" available for 30 seconds

Ethical boundary: Keep rules transparent and predictable -- never hide rules that manipulate behavior, such as making unsubscribe harder than subscribe.

See: references/rules-and-state.md for state management, constraints, error states, and edge cases.

3. Feedback

Core concept: Feedback communicates the rules to the user, answering "What is happening right now?" -- visually (color, animation, movement), aurally (clicks, chimes), or haptically (vibration). Show only what matters: minimal, meaningful, contextual.

Why it works: Without feedback, users cannot tell if their action registered, the system is working, or the operation succeeded. Too little feedback creates anxiety; too much creates noise; the right feedback at the right time makes interactions feel responsive and trustworthy.

Key insights:

  • Feedback must be immediate -- under 100ms for direct manipulation
  • Use the least noticeable feedback that still communicates, and prefer animating existing elements (the button itself, not a separate toast)
  • Scale feedback to event significance: small action = small feedback, big result = big feedback
  • Visual feedback is primary; audio and haptic are supplementary, never the only channel
  • Progress indicators reduce perceived wait time even when actual time is unchanged

Product applications:

ContextApplicationExample
Button pressVisual state change on clickButton depresses, color shifts, text becomes "Saving..."
Form validationInline feedback as user typesGreen checkmark next to valid email field
Error stateContextual error near the sourceRed border on field + "Password must be 8+ characters"

Ethical boundary: Keep feedback honest -- no fake progress bars, manipulative countdowns, or deceptive completion percentages.

See: references/feedback-patterns.md for feedback channels, timing, and preventing overload.

4. Loops and Modes

Core concept: Loops are the meta-rules over time -- does the interaction change after the 100th use, expire, adapt? Modes are forks in the rules where the same control temporarily behaves differently (edit mode vs. view mode).

Why it works: Thoughtful loops let microinteractions mature gracefully -- reducing friction for power users while staying discoverable for new ones. Modes, used sparingly, let one control serve multiple purposes without cluttering the interface.

Key insights:

  • Open loops continue until explicitly stopped (a repeating alarm); closed loops run once and end (a timer)
  • Long loops change the interaction over time: first use shows a tooltip; the 50th does not
  • Progressive reduction: strip away scaffolding as users demonstrate mastery
  • Modes are dangerous -- they violate "same action, same result"; minimize them and make the current mode highly visible (Caps Lock indicator, edit banner)

Product applications:

ContextApplicationExample
Onboarding tooltipsLong loop removes hints after N usesFirst 3 sessions show "Swipe to archive"; then stop
Alarm clockOpen loop repeats until disabledFires every weekday at 7am until toggled off
Text editingMode: view vs. editBanner reads "Editing" with a "Done" button to exit

Ethical boundary: Loops should benefit the user, not the business -- never adapt loops to ramp up notifications or make opt-outs progressively harder.

See: references/loops-modes.md for long loops, mode errors, and progressive complexity.

5. Signature Moments

Core concept: A signature moment is a microinteraction so distinctive it becomes part of the product's identity -- the Facebook Like, slide-to-unlock, Slack's loading messages. Every product should have one or two; not every interaction should be one.

Why it works: Signature moments create emotional memory and make products feel crafted rather than assembled. They are what users demonstrate first when describing your product to others.

Key insights:

  • Put signature moments on frequent, visible actions -- not buried settings
  • Functional first, delightful second -- never sacrifice usability for novelty
  • Animation, sound, and copy are the three most common tools
  • Align with brand personality: playful brands get playful moments
  • Apply the removal test: if users would not miss it, it is decoration, not signature

Product applications:

ContextApplicationExample
Social reactionAnimated response to engagementFacebook Like: thumbs-up animates with particles
Loading stateBranded waiting experienceSlack: rotating quotes during load
CompletionCelebratory confirmationStripe payment: animated checkmark with confetti

Ethical boundary: Never obscure important information or delay the user to show off an animation -- function precedes delight.

See: references/signature-moments.md for when to invest and making mundane interactions delightful.

6. Reducing and Simplifying

Core concept: The best microinteraction is barely noticed because it is so simple and fast. Reduce (fewer options, steps, decisions), then simplify what remains until it feels effortless.

Why it works: Every option, field, and decision adds cognitive load -- users do not want to configure a toggle, they want it to work. The most elegant microinteractions have zero configuration, one action, and immediate results.

Key insights:

  • If a microinteraction needs instructions, it is too complex
  • Remove options with smart defaults -- pick the best choice and commit to it
  • Collapse multi-step interactions into a single action where possible
  • Use progressive disclosure: show simple first, reveal complexity only on request
  • Keep rule count proportional to frequency of use: common actions need few rules

Product applications:

ContextApplicationExample
Smart defaultsEliminate configurationCamera app opens in photo mode, not settings
Single actionOne tap replaces multi-step flowDouble-tap to like instead of menu + select reaction
Anticipatory designPredict and pre-fillShipping form fills city and state from ZIP code

Ethical boundary: Do not auto-opt users into business-serving features or remove control over meaningful choices.

Common Mistakes

MistakeWhy It FailsFix
No feedback on actionUsers cannot tell if their tap registeredAdd immediate visual state change to every interactive element
Overdesigning simple momentsComplex animations slow frequent actionsReserve rich animation for infrequent, high-impact moments
Ignoring edge casesInteraction breaks at zero, max, or double-tapMap every state: empty, loading, partial, full, error, disabled
Invisible triggersUsers cannot discover functionalityPair gesture triggers with a visible alternative
Mode errorsSame action gives different results based on hidden stateMake current mode visible; minimize modes
Ignoring long loopsInteraction feels identical on day 1 and day 100Use progressive reduction for returning users
Feedback overloadEvery action triggers a toast, sound, or animationUse the smallest feedback that communicates
Fake progress indicatorsUsers feel deceived when they discover the bar is fakeUse honest, deterministic progress; indeterminate spinner when unknown

Quick Diagnostic

Audit any microinteraction:

QuestionIf NoAction
Is there a clear, discoverable trigger?Users cannot initiate the interactionAdd a visible control or affordance
Does the trigger show its current state?Users cannot tell if it is on, off, or loadingAdd distinct visual states for every trigger state
Are the rules simple and predictable?Users are confused by what happenedSimplify rules; match platform conventions
Is there immediate feedback?Users question whether their action workedAdd visual response within 100ms
Does feedback match the event's significance?Small actions feel dramatic, or big results feel trivialScale feedback to event importance
Does the interaction evolve over time?Power users still see beginner hintsAdd progressive reduction through long loops
Is the interaction free of unnecessary modes?Users perform the wrong action in the wrong modeRemove modes or make the current mode highly visible
Could a first-time user figure it out without help?Interaction needs explanationSimplify or add a one-time hint via long loop

Reference Files

  • trigger-design.md: Manual and system triggers, trigger affordances, trigger states, invisible trigger design, placement and visibility
  • rules-and-state.md: Defining rules, state management, constraints, error states, edge cases
  • feedback-patterns.md: Visual, audio, and haptic feedback, timing, progressive disclosure, preventing overload
  • loops-modes.md: Open and closed loops, long loops, modes, mode errors, progressive complexity
  • signature-moments.md: Brand-defining microinteractions, examples, when to invest, making mundane interactions delightful
  • case-studies.md: Detailed design breakdowns of form submission, toggle/switch, pull-to-refresh, loading states, and notifications

Further Reading

This skill is based on Dan Saffer's definitive guide to designing with details:

About the Author

Dan Saffer is a designer and design leader who has led teams at Twitter, Jawbone, and Smart Design. His book Microinteractions codified the framework design teams worldwide use to audit, design, and improve the small details that make products feel polished and alive. He also wrote Designing for Interaction and Designing Gestural Interfaces.

---

Credits & Attribution

This skill is based on the excellent work by [wondelai](https://github.com/wondelai).

Original repository: https://github.com/wondelai/skills

Copyright (c) wondelai - Microinteractions framework adaptation of Dan Saffer's Microinteractions: Designing with Details (MIT License)

Special thanks to wondelai for their generous open-source contributions, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.