Communitygithub.com

ux-motion-craft

Design, refine, or review product interfaces using 20 UX and animation principles and 20 concrete fixes for generic AI design. Use for interface polish, purposeful motion, visual hierarchy, usability reviews, and removing unnecessary decoration.

What is ux-motion-craft?

ux-motion-craft is a Claude Code agent skill that design, refine, or review product interfaces using 20 UX and animation principles and 20 concrete fixes for generic AI design. Use for interface polish, purposeful motion, visual hierarchy, usability reviews, and removing unnecessary decoration.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuanSol30/ux-motion-craft/tree/HEAD

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

UX Motion Craft

Turn the user's 40 design principles into deliberate interface decisions. Improve task clarity, ease of use, and feedback while preserving the product's identity and existing design system. Apply the principles that fit the task; do not force every principle into every screen.

Working approach

  1. Identify the user's main task, audience, platform, primary action, and existing component conventions. Inspect the actual interface or source before proposing specific fixes. If only a screenshot is available, distinguish visible findings from interaction assumptions.
  2. For visual refinement, use the 20 design cleanup principles below. For interaction, animation, or usability work, use the 20 UX and animation principles below. For a complete new screen or broad review, use both.
  3. Prioritize broken or inaccessible interactions, then hierarchy and content, then decorative polish. Keep useful labels, status information, and established navigation even when simplifying.
  4. For implementation requests, make the changes and verify relevant states. For review requests, report findings with concrete evidence and proposed fixes; a review does not authorize editing the product.
  5. Validate the main task on relevant viewport sizes, with keyboard input, reduced motion, loading, success, error, and interruption states as applicable. Report what was actually checked and any unresolved limitations.

Decision rules

  • Treat the laws as decision aids, not universal formulas. Miller's law is not a seven-item menu limit; the Doherty threshold is not a license to delay feedback. Validate assumptions in the product's context.
  • Let motion explain state, spatial relationships, progress, or feedback. A subtle interface can satisfy the animation principles without visible bouncing or a 3D scene.
  • Preserve readable text, focus indicators, accessible names, and meaningful status. Removing a redundant visual label must not remove information required by assistive technology.
  • Respect reduced-motion preferences. Use immediate state changes or restrained fades when spatial movement is unnecessary. Never make correctness depend on animation completion.
  • Use the existing stack and design tokens. Introduce a dependency only when the task needs it and the project's conventions support it.
  • Do not manufacture product screenshots, testimonials, performance numbers, or claims to make a design appear more credible.

Useful output

For a review, give the most consequential findings first. Identify the affected element, the observed issue, the relevant principle, and the concrete correction. Mark unverified interactions as needing inspection. Avoid a numeric quality score without a defined rubric.

For implemented changes, describe the resulting behavior, summarize meaningful verification, and state any remaining limitations. Mention only the principles that actually shaped the work; do not recite all 40 points.

20 Principles of UX & Animation

Use principles 1-12 to improve motion and composition; use 13-20 to improve interaction. Preserve the user's numbering so findings can reference individual principles.

#PrinciplePractical applicationBoundary or verification
1Squash & stretchUse a restrained compression or expansion to communicate a press, elastic object, or successful completion when appropriate to the product.Keep text and icons readable; do not distort hit areas or cause layout shifts. Omit elastic motion in restrained products.
2Anticipation wind-upSignal an upcoming consequential action with a preview, pressed state, drag affordance, or clear preparation.Do not add a theatrical delay before routine actions. Consequential actions may need explicit confirmation rather than animation.
3Staging the focusGive the current task and its main action clear visual priority. Use dimming, spacing, and motion to direct attention.Competing animations must not fight for focus. Maintain contrast and visible keyboard focus.
4Pose to poseDefine initial, active, completed, cancelled, and failed states before interpolating between them.Each final state must render correctly with animation disabled, skipped, or interrupted.
5Follow throughLet a secondary visual settle briefly after a movement when this helps communicate material or continuity.Do not delay input, navigation, or the final semantic state until a spring settles.
6Slow in & slow outMatch acceleration and deceleration to entering, leaving, and changing state. Use shared easing tokens.Constant progress may need linear motion. Avoid treating one easing curve as appropriate everywhere.
7Moving in arcsUse curved paths for expressive objects or gestures where the path clarifies their destination.Direct movement is often clearer for menus, forms, and data. Avoid unnecessary spatial travel and respect reduced motion.
8Secondary actionSupport the primary action with a related cue, such as a count update after adding an item.Do not steal attention or rely on motion alone to convey the result.
9Snappy timingShow immediate acknowledgment and use the shortest transition that communicates the change clearly.Judge timing against travel distance, input speed, and context. Test rapid repeated input; never add delay to appear polished.
10Exaggerated feedbackIncrease the clarity of important feedback through hierarchy, wording, contrast, or restrained motion.Scale emphasis to consequence. Routine success should not resemble an emergency; do not flash or shake aggressively.
11Solid drawing in 3DWhen using 3D, maintain coherent perspective, depth, lighting, occlusion, and believable volume. In 2D, maintain coherent layering and object boundaries.Do not introduce 3D just to satisfy this principle. Check clipping, shadows, and transformed text.
12Overall appealBuild a coherent visual personality through proportion, typography, color, composition, and consistent behavior.Appeal serves the product and audience; novelty and decoration are not evidence of usability.
13Fitts's lawMake important targets easy to reach by considering their size and distance from the likely pointer or thumb position.Do not reduce this to bigger buttons everywhere. Check placement, adjacent targets, and the actual task path.
14Bigger hit areasExpand the interactive region around small visible controls and make the complete intended row or label clickable.Keep targets from overlapping. Use platform guidance and verify pointer, touch, and keyboard activation.
15Hick's lawReduce decision complexity with clear labels, meaningful groups, useful defaults, and progressive disclosure.Do not hide essential choices or add extra steps solely to reduce visible item count. Search and expertise change the tradeoff.
16Miller's lawGroup related information, externalize state, and favor recognition over remembering details across steps.Do not enforce seven plus or minus two items as a universal navigation rule. Chunk by meaning and test comprehension.
17Doherty thresholdKeep acknowledgment fast enough to maintain a sense of direct interaction; provide meaningful progress for longer work.Roughly 400 ms is a historical heuristic, not a universal pass/fail standard. Show input feedback immediately and measure actual latency.
18Postel's lawAccept harmless formatting variations, normalize predictable input, and show specific recovery guidance.Do not silently guess ambiguous dates, money, identities, or destructive intent. Validate strictly at trust boundaries and preserve user meaning.
19Jakob's lawUse familiar controls, labels, navigation, and interaction patterns so existing knowledge transfers.Adapt conventions to the platform and audience. Do not copy an unsuitable pattern or brand blindly.
20Frequency of useGive frequent tasks convenient placement and efficient paths; keep rare actions discoverable without crowding primary work.Frequency is not importance. Rare critical or emergency actions may need prominent access, and destructive actions need safeguards.

Motion implementation checks

  • Define animation intent in a sentence: what relationship or state becomes easier to understand?
  • Prefer transforms and opacity when practical, and inspect actual rendering performance. Do not apply blanket transitions to every property.
  • Keep visual feedback independent of network completion. Do not show success before the operation succeeds.
  • Keep semantic state, focus, and accessible status synchronized with the operation. Avoid repeated live-region announcements during animation frames.
  • Cancel or replace previous transitions on rapid input. Set the new target state explicitly; handle unmounts and navigation without orphaned timers or event handlers.
  • Test reduced motion, repeated toggling, interrupted loading, and failed operations. A static screenshot cannot verify these behaviors.

20 Ways to Unslop AI Designs

Remove generic decoration and strengthen the actual product. Preserve useful information, accessibility, and the user's intended style. These are editorial criteria, not a requirement to make every product minimal.

#PrincipleApply itPreserve or verify
1Delete filler badgesRemove chips such as generic AI-powered or next-generation labels when they add no decision value.Keep real status, availability, compliance information, or other badges that users need.
2Drop redundant labelsRemove visible labels that repeat nearby context without improving comprehension.Keep input labels, accessible names, units, and context needed after scrolling or on small screens.
3Unitalicize random wordsUse emphasis only when it communicates a deliberate hierarchy or editorial meaning.Preserve intentional brand typography and meaningful italics.
4Mono only where neededReserve monospace for code, identifiers, or data where fixed-width alignment helps.Ordinary body text and navigation should use the product's readable text styles. Numbers can use tabular figures without monospace.
5Use a design systemReuse tokens and components for color, spacing, type, radii, elevation, and interaction states.Extend the established system rather than creating an unrelated parallel theme.
6Show the actual productGive the real interface, service, result, or artifact a concrete place in the composition.Use verified assets or clearly marked mockups. Do not invent screenshots, customer logos, or product capabilities.
7Enlarge the main featureGive the central task, useful preview, or defining product feature enough space to be understood.Do not enlarge decoration or push the primary action out of reach. Check small viewports.
8Group with spacingUse proximity and whitespace to express relationships before adding borders or cards.Keep related labels and controls together and maintain a sensible reading order.
9Make headlines specificSay what the product does, for whom, or what result it enables in concrete language.Do not add unsupported claims or numbers. Keep essential meaning visible when headings wrap.
10Emphasize the CTAMake the primary next action visually clear and label it with a concrete verb and object.Secondary actions remain discoverable. Repeated primary actions can be useful in long pages; avoid competing primary actions within one decision area.
11Add an accent colourUse a deliberate accent to establish identity and highlight key actions or selection.Reuse the existing brand palette when present. Do not use accent color everywhere or make color the only signal.
12Keep icons consistentUse a coherent icon family, optical size, stroke, and placement.Give icon-only buttons accessible names and tooltips where helpful. Do not replace clear labels with unexplained symbols.
13Remove embellishmentsRemove arbitrary gradients, blobs, sparkles, grids, or shadows that obscure hierarchy or slow rendering.Keep decoration that deliberately serves the brand, story, or comprehension.
14Inner radius = outer - paddingFor uniformly inset rounded rectangles, start with inner radius = max(0, outer radius - inset).Use the actual gap between boundaries, including borders as appropriate. This is a geometric starting point; optical adjustments and irregular shapes need judgment.
15Improve text contrastCheck actual foreground/background pairs, including muted text, placeholders, disabled explanations, and overlays.Use the applicable accessibility standard; for typical web AA, normal text needs 4.5:1 and large text 3:1. Verify rather than judging from hex values in isolation.
16Wrap headlines properlyLet headings wrap naturally at useful widths; use balanced wrapping as a progressive enhancement when suitable.Test narrow screens, localization, zoom, and long words. Avoid forced line breaks or nonbreaking spaces that only work at one width.
17Align by eye, not pixelsRefine icon centering, text baselines, and perceived visual weight after structural alignment is correct.Use systematic layout first. Optical corrections should be small and purposeful, not arbitrary offsets for every element.
18Use tabular numsApply tabular figures to changing counters, prices in comparison columns, timers, and aligned numeric data.Keep locale-aware formatting, units, and readable precision. Ordinary prose does not require tabular figures.
19Add loading statesShow acknowledgment and appropriate progress while real work happens; reserve layout space and provide recovery on failure.Do not show fake progress or add artificial wait time. Prevent accidental duplicate submissions and maintain accessible status.
20Animate useful feedbackAnimate changes that clarify cause and effect, such as selection, expansion, completion, or repositioning.Respect reduced motion, preserve focus, and support interruption. Avoid autoplay motion that competes with the task.

Review method

Inspect the main task first, then ask:

  • Can a new user identify what the product does and its next useful action?
  • Is the actual product prominent enough to understand?
  • Does each badge, icon, label, card, and effect earn its space?
  • Do spacing, type, and color communicate a coherent hierarchy?
  • Are key controls usable with touch, keyboard, zoom, and assistive technology?
  • Do loading, error, empty, success, and reduced-motion states remain clear?

Choose changes based on user impact, not the number of checklist items satisfied. For example, removing a billing-status badge to reduce clutter is a regression when that badge prevents a mistaken payment.

Related Skills