Agent skill

Microinteractions

by wondelai in wondelai/skills

Design the small details -- triggers, rules, feedback, loops and modes -- that separate good products from great ones.

MITAuto-check passedFrontend & Design

Install Microinteractions

skills CLI
$ npx skills add wondelai/skills --skill microinteractions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wondelai/skills microinteractions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wondelai/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/microinteractions .claude/skills/microinteractions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
microinteractions
GitHub stars
2.4k
Token cost
~3.8k tokens
SKILL.md length
1,876 words
Files
7 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Design the small details -- triggers, rules, feedback, loops and modes -- that separate good products from great ones.

  • Works in 6 steps: Triggers → Rules → Feedback → …
  • The user mentions microinteraction
  • SKILL.md covers Core Principle, Scoring, The Microinteraction Structure and Common Mistakes, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Microinteractions is an agent skill from wondelai/skills. Design the small details -- triggers, rules, feedback, loops and modes -- that separate good products from great ones. Use when the user mentions "microinteraction", "button feedback", "loading state", "toggle design", "animation detail", "state transitions", "input feedback", "the interface feels dead", "make the UI feel responsive", or "add polish to interactions". Also trigger when designing form-validation responses, progress indicators, confirmation dialogs, or any element where the user expects immediate…

Its SKILL.md is about 3.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/case-studies.md`, `references/feedback-patterns.md` and `references/loops-modes.md`).

It sits in Frontend & Design, covering UI design, Forms and validation and Refactoring. The repository describes itself as: Wondel.ai Agent Skills — Business, Marketing, UX & Coding Frameworks from Bestselling Books. 50 skills + 12 guided journeys for Claude Code, Codex, Cursor & other agentskills.io… The licence is MIT.

When your agent uses it

  • The user mentions microinteraction
  • Button feedback
  • Animation detail
  • State transitions

Example prompts

  • “microinteraction”
  • “button feedback”
  • “loading state”
  • “/microinteractions”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Triggers
  2. Rules
  3. Feedback
  4. Loops and Modes
  5. Signature Moments
  6. Reducing and Simplifying

What it can do on your machine

Read from SKILL.md and the folder at commit c172996. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • amazon.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Microinteractions loads about 3.8k tokens when it runs, and up to ~27k if it reads all its reference files. Until then it costs about 179 tokens; SKILL.md has 1,876 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~179
When it runs · the whole SKILL.md, loaded when a task matches
~3.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~27k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wondelai/skills at commit c172996, republished under its MIT licence (© wondelai). 1,876 words, ~3,806 tokens.

Download SKILL.mdSave it as .claude/skills/microinteractions/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
microinteractions
description
Design the small details -- triggers, rules, feedback, loops and modes -- that separate good products from great ones. Use when the user mentions "microinteraction", "button feedback", "loading state", "toggle design", "animation detail", "state transitions", "input feedback", "the interface feels dead", "make the UI feel responsive", or "add polish to interactions". Also trigger when designing form-validation responses, progress indicators, confirmation dialogs, or any element where the user expects immediate feedback. Covers trigger design, state rules, feedback mechanisms, and progressive loops. For overall UI polish, see refactoring-ui. For affordance design, see design-everyday-things.
license
MIT
metadata.author
wondelai
metadata.version
1.4.1

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. Score by how many of the 8 Quick Diagnostic rows the microinteraction passes — score = round(passed / 8 × 10), then read the band:

  • 9-10 = passes all 8 rows: deliberate discoverable trigger with visible states, simple predictable rules, sub-100ms feedback scaled to event significance, evolves over time, mode-free or mode-visible, learnable without help.
  • 5-6 = 4-5 rows pass: it works but has a generic feel -- e.g. feedback exists but is uniform, or the trigger lacks distinct states.
  • <=3 = 2 or fewer rows pass: missing feedback, invisible triggers, or hidden modes that break trust.

Always state the current score, which diagnostic rows failed, and the specific fix for each.

The Microinteraction Structure

Six areas of focus for designing world-class microinteractions. See references/case-studies.md when you want a full four-part breakdown of a real pattern -- form submission, toggle/switch, pull-to-refresh, loading states, and notifications, each from first use through edge cases.

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: A trigger's prominence and labeling set the user's expectation before they act -- a button that reads "Delete" in red signals an irreversible, high-stakes outcome, so feedback that follows feels predictable rather than surprising.

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 or the system is working, so they retap, abandon, or distrust the result. Feedback is what converts an invisible system state into a perceived response.

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.

Show full SKILL.md (779 more words)Show less
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 block input or the next step behind a non-skippable celebration animation -- let the user tap through the confetti to proceed.

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: A "smart default" must serve the user, not the business -- never pre-check marketing opt-ins, paid add-ons, or data-sharing as the default choice.

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

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.

© wondelai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in microinteractions of wondelai/skills.

  • SKILL.md
  • references/case-studies.md
  • references/feedback-patterns.md
  • references/loops-modes.md
  • references/rules-and-state.md
  • references/signature-moments.md
  • references/trigger-design.md

Open the folder on GitHubat commit c172996

Compare with similar skills

Microinteractions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Microinteractions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Microinteractions this skillwondelai/skills2.4k—~3.8kAutomated safety check: PassMIT
Refactoring UI Designchaxus/ran271—~1.9kAutomated safety check: PassMIT
Tidyfactor StylerTidyFactor/Styler118—~1.7kAutomated safety check: PassApache-2.0
Composer Pluginsdxos/dxos525—~13kAutomated safety check: PassCustom licence
Frontend Developmentavibebuilder/claude-prime120—~1.3kAutomated safety check: PassMIT
Chamilo Vue Base Componentschamilo/chamilo-lms1k—~7.6kAutomated safety check: NotesGPL-3.0

Similar skills

  • A skill your agent uses when designing, reviewing, or improving web UI visual quality, especially when a developer-built interface feels cluttered, flat, generic, poorly spaced, weakly hierarchical…

    271 GitHub stars~1.9k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Tidyfactor Styler

    TidyFactor/Styler

    Production framework styler and surgical RTL UI polish engine with Contextual Decision Layer (CDL).

    118 GitHub stars~1.7k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • A skill your agent uses when working on files in packages/plugins/, adding new plugins, refactoring plugin components/containers, writing storybooks for plugins, or wiring capabilities like…

    525 GitHub stars~13k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Frontend Development

    avibebuilder/claude-prime

    A skill your agent uses for ANY work involving React, Next.js, TypeScript, or Tailwind in the browser layer.

    120 GitHub stars~1.3k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Chamilo Vue Base Components

    chamilo/chamilo-lms

    Swaps native form elements in Chamilo Vue files for Base components and checks that every Base, SectionHeader and Fieldset tag has its import.

    1k GitHub stars~7.6k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Scraps Review

    getsentry/sentry

    Official

    Filter large Sentry Scraps design-system migration PRs for review by separating mechanical import-path changes, generated baseline updates, snapshot mocks, and pure renames from substantive…

    46k GitHub stars~1.2k tokensUpdated today
    Frontend & DesignAuto-check: notes

More from wondelai/skills

All 61 skills in this repo
  • Crossing The Chasm

    wondelai/skills

    Navigate the technology adoption lifecycle from early adopters to mainstream market.

    2.4k GitHub stars~3.6k tokensUpdated 27 days ago
    Auto-check passed
  • Design Everyday Things

    wondelai/skills

    Apply foundational design principles: affordances, signifiers, constraints, feedback, and conceptual models.

    2.4k GitHub stars~4k tokensUpdated 27 days ago
    Auto-check passed
  • Design Sprint

    wondelai/skills

    Run a structured 5-day process to prototype, test, and validate product ideas with real users.

    2.4k GitHub stars~3.8k tokensUpdated 27 days ago
    Auto-check passed
  • Hooked UX

    wondelai/skills

    Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment).

    2.4k GitHub stars~3.5k tokensUpdated 27 days ago
    Auto-check passed
  • Improve Retention

    wondelai/skills

    Diagnose and fix retention problems using behavior design (B=MAP).

    2.4k GitHub stars~3.8k tokensUpdated 27 days ago
    Auto-check passed
  • Monetizing Innovation

    wondelai/skills

    Design products and pricing around validated willingness to pay, from Ramanujam & Tacke's "Monetizing Innovation".

    2.4k GitHub stars~5.2k tokensUpdated 27 days ago
    Auto-check passed

Questions about Microinteractions

What does Microinteractions do?

Design the small details -- triggers, rules, feedback, loops and modes -- that separate good products from great ones. Microinteractions is an agent skill from wondelai/skills. Design the small details -- triggers, rules, feedback, loops and modes -- that separate good products from great ones.

When should I use Microinteractions?

Microinteractions fits situations like: the user mentions microinteraction; button feedback; animation detail; state transitions.

How do I install Microinteractions in Claude Code?

Run `npx skills add wondelai/skills --skill microinteractions -a claude-code`. Or copy the skill folder (microinteractions in wondelai/skills) into .claude/skills/microinteractions in your project. Claude Code loads it when a task matches its description.

How do I install Microinteractions in Codex?

Run `npx skills add wondelai/skills --skill microinteractions -a codex`. Or copy the skill folder (microinteractions in wondelai/skills) into .agents/skills/microinteractions in your project. Codex loads it when a task matches its description.

Can I use Microinteractions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wondelai/skills --skill microinteractions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/microinteractions, .gemini/skills/microinteractions, .github/skills/microinteractions and .opencode/skills/microinteractions in your project.

What does Microinteractions need to run?

SKILL.md names no scripts, command-line tools or credentials: Microinteractions is instructions for the agent only.

Does Microinteractions access the network?

SKILL.md names 1 domain. As links in the text: amazon.com. This is read from the text; nothing was executed.

Is Microinteractions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Microinteractions use?

Microinteractions is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Microinteractions use?

About 3.8k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 23k tokens, read only when the agent opens those files.

What are the alternatives to Microinteractions?

Skills that share tags, products or a category with Microinteractions: Refactoring UI Design (chaxus/ran, 271 stars), Tidyfactor Styler (TidyFactor/Styler, 118 stars), Composer Plugins (dxos/dxos, 525 stars) and Frontend Development (avibebuilder/claude-prime, 120 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Microinteractions?

wondelai (a GitHub organization) maintains it in wondelai/skills, which has 2,356 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on September 10, 2026.

Source: wondelai/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.