Back to Skills

userinterface-wiki

UI/UX best practices for web interfaces. Use when reviewing animations, CSS, audio, typography, UX patterns, prefetching, or icon implementations. Covers 11 categories from animation principles to typography. Outputs file:line findings.

760stars33forksUpdated 5/18/2026

Security Assessment

Safe(100/100)
Security Score100/100

About userinterface-wiki

The `userinterface-wiki` skill is a comprehensive guide for UI/UX best practices specifically tailored for web interfaces. It addresses common challenges in designing interactive and visually appealing web applications, helping developers, designers, and code reviewers ensure consistent, user-friendly experiences. By consolidating 152 rules across 12 categories, the skill provides clear guidance on implementing animations, typography, audio feedback, iconography, and other critical interface elements, highlighting the impact of each rule to prioritize development and review efforts.

This skill covers a wide range of capabilities including animation principles, timing functions, exit animations, CSS pseudo-elements, audio feedback, sound synthesis, morphing icons, container animation, laws of UX, predictive prefetching, typography, and visual design. Each category includes specific rules with prefixes that facilitate automated code review and generation. Key features include recommendations for gesture-based interactions, natural motion easing, modal and z-index handling, predictive prefetching for improved perceived performance, and adherence to cognitive psychology principles such as Fitts's, Hick's, and Miller's laws.

`userinterface-wiki` is intended for web developers, UI/UX designers, and teams performing automated or manual code reviews. It is particularly useful when reviewing CSS transitions, animations with frameworks like Framer Motion, interactive feedback mechanisms, typography setups, and visual design consistency. The skill ensures best practices are applied, helping teams create interfaces that are both performant and aligned with modern usability standards. It also serves as a reference for implementing accessibility-friendly interactions and precise timing for user-driven motions.

FAQ

When should I use the `userinterface-wiki` skill?

Use this skill when reviewing or implementing web interface elements, including animations, typography, audio feedback, predictive prefetching, and visual design patterns.

Is the skill compatible with CSS frameworks and animation libraries?

Yes, it is designed to guide best practices for standard CSS, pseudo-elements, the View Transitions API, as well as animation libraries like Framer Motion and AnimatePresence.

Does `userinterface-wiki` cover accessibility considerations?

Yes, several rules include guidance for accessibility, such as audio feedback and interaction timing, ensuring interfaces remain usable for diverse users.

Are there any limitations in using this skill?

The skill focuses on guidelines and rule-based recommendations; it does not include automated code enforcement or runtime behavior testing.

What are the requirements to use this skill effectively?

Users should have a basic understanding of web development, CSS, UI animations, and UX principles to interpret and apply the rules effectively.

All Files

157 files
metadata.json1.6 KB
View
rules/a11y-volume-control.md0.4 KB
View
rules/container-no-excessive-use.md0.4 KB
View
SKILL.md13.8 KB
View
rules/appropriate-errors-warnings.md0.3 KB
View
rules/container-transition-delay.md0.5 KB
View
AGENTS.md85.2 KB
View
rules/appropriate-confirmations-only.md0.3 KB
View
rules/container-overflow-hidden.md0.6 KB
View
rules/design-noise-for-percussion.md0.5 KB
View
rules/easing-for-state-change.md0.4 KB
View
rules/a11y-reduced-motion-check.md0.5 KB
View
rules/appropriate-no-punishing.md0.5 KB
View
rules/context-cleanup-nodes.md0.4 KB
View
rules/duration-shorten-before-curve.md0.4 KB
View
rules/easing-transition-ease-in-out.md0.3 KB
View
rules/impl-default-subtle.md0.3 KB
View
rules/a11y-toggle-setting.md0.5 KB
View
rules/container-callback-ref.md0.7 KB
View
rules/context-resume-suspended.md0.4 KB
View
rules/duration-small-state.md0.2 KB
View
rules/envelope-exponential-decay.md0.4 KB
View
rules/impl-preload-audio.md0.6 KB
View
rules/morphing-jump-non-grouped.md0.6 KB
View
rules/_sections.md3.2 KB
View
rules/appropriate-no-decorative.md0.3 KB
View
rules/container-two-div-pattern.md0.8 KB
View
rules/duration-max-300ms.md0.3 KB
View
rules/easing-natural-decay.md0.5 KB
View
rules/exit-prop-required.md0.6 KB
View
rules/morphing-aria-hidden.md0.3 KB
View
rules/morphing-use-collapsed.md0.5 KB
View
rules/none-keyboard-navigation.md0.5 KB
View
rules/physics-subtle-deformation.md0.5 KB
View
rules/_template.md0.4 KB
View
rules/appropriate-no-high-frequency.md0.5 KB
View
rules/container-use-resize-observer.md1.1 KB
View
rules/duration-press-hover.md0.4 KB
View
rules/easing-no-linear-motion.md0.5 KB
View
rules/exit-requires-wrapper.md0.4 KB
View
rules/morphing-consistent-viewbox.md0.4 KB
View
rules/native-backdrop-styling.md0.5 KB
View
rules/param-click-duration.md0.4 KB
View
rules/a11y-visual-equivalent.md0.7 KB
View
rules/container-guard-initial-zero.md0.6 KB
View
rules/context-reuse-single.md0.5 KB
View
rules/easing-entrance-ease-out.md0.4 KB
View
rules/envelope-no-zero-target.md0.4 KB
View
rules/impl-reset-current-time.md0.4 KB
View
rules/morphing-reduced-motion.md0.6 KB
View
rules/nested-consistent-timing.md0.6 KB
View
rules/param-reasonable-gain.md0.3 KB
View
rules/prefetch-touch-fallback.md0.6 KB
View
rules/design-filter-for-character.md0.5 KB
View
rules/easing-exit-ease-in.md0.3 KB
View
rules/envelope-set-initial-value.md0.4 KB
View
rules/mode-pop-layout-for-lists.md0.5 KB
View
rules/morphing-spring-rotation.md0.5 KB
View
rules/nested-propagate-required.md0.8 KB
View
rules/physics-active-state.md0.5 KB
View
rules/prefetch-trajectory-over-hover.md0.6 KB
View
rules/pseudo-marker-styling.md0.5 KB
View
rules/design-oscillator-for-tonal.md0.4 KB
View
rules/easing-linear-only-progress.md0.4 KB
View
rules/exit-matches-initial.md0.5 KB
View
rules/mode-wait-doubles-duration.md0.5 KB
View
rules/morphing-three-lines.md0.5 KB
View
rules/none-high-frequency.md0.5 KB
View
rules/physics-spring-for-overshoot.md0.6 KB
View
rules/presence-disable-interactions.md0.6 KB
View
rules/pseudo-position-relative-parent.md0.5 KB
View
rules/exit-key-required.md0.5 KB
View
rules/mode-sync-layout-conflict.md0.6 KB
View
rules/morphing-strokelinecap-round.md0.3 KB
View
rules/none-context-menu-entrance.md0.5 KB
View
rules/physics-no-excessive-stagger.md0.4 KB
View
rules/prefetch-use-selectively.md0.5 KB
View
rules/pseudo-over-dom-node.md0.5 KB
View
rules/staging-one-focal-point.md0.5 KB
View
rules/transition-over-js-library.md0.6 KB
View
rules/type-oldstyle-nums-for-prose.md0.4 KB
View
rules/morphing-group-variants.md0.9 KB
View
rules/native-placeholder-styling.md0.5 KB
View
rules/param-filter-frequency-range.md0.3 KB
View
rules/prefetch-keyboard-tab.md0.4 KB
View
rules/pseudo-content-required.md0.5 KB
View
rules/spring-for-interruptible.md0.5 KB
View
rules/timing-under-300ms.md0.5 KB
View
rules/type-font-display-swap.md0.6 KB
View
rules/native-selection-styling.md0.3 KB
View
rules/param-q-value-range.md0.3 KB
View
rules/prefetch-not-everything.md0.5 KB
View
rules/pseudo-first-line-styling.md0.6 KB
View
rules/spring-params-balanced.md0.4 KB
View
rules/transition-name-cleanup.md0.6 KB
View
rules/type-justify-with-hyphens.md0.4 KB
View
rules/type-proper-fractions.md0.3 KB
View
rules/type-slashed-zero.md0.3 KB
View
rules/ux-common-region-boundaries.md1.1 KB
View
rules/prefetch-hit-slop.md0.5 KB
View
rules/presence-safe-to-remove.md0.7 KB
View
rules/spring-for-gestures.md0.4 KB
View
rules/timing-no-entrance-context-menu.md0.5 KB
View
rules/type-disambiguation-stylistic-set.md0.3 KB
View
rules/ux-aesthetic-usability.md0.6 KB
View
rules/presence-hook-in-child.md0.5 KB
View
rules/pseudo-z-index-layering.md0.5 KB
View
rules/timing-consistent.md0.6 KB
View
rules/type-antialiased-on-retina.md0.4 KB
View
rules/type-optical-sizing-auto.md0.4 KB
View
rules/type-variable-weight-continuous.md0.5 KB
View
rules/ux-goal-gradient-progress.md0.7 KB
View
rules/ux-progressive-disclosure.md0.8 KB
View
rules/visual-animate-shadow-pseudo.md0.9 KB
View
rules/pseudo-hit-target-expansion.md0.5 KB
View
rules/spring-preserves-velocity.md0.5 KB
View
rules/transition-name-required.md0.5 KB
View
rules/type-letter-spacing-uppercase.md0.5 KB
View
rules/type-tabular-nums-for-data.md0.4 KB
View
rules/ux-doherty-perceived-speed.md0.6 KB
View
rules/ux-pareto-prioritize-features.md0.7 KB
View
rules/ux-teslers-complexity.md0.5 KB
View
rules/visual-consistent-spacing-scale.md0.6 KB
View
rules/staging-dim-background.md0.5 KB
View
rules/transition-name-unique.md0.4 KB
View
rules/type-no-font-synthesis.md0.3 KB
View
rules/type-text-wrap-balance-headings.md0.4 KB
View
rules/ux-doherty-under-400ms.md0.6 KB
View
rules/ux-peak-end-finish-strong.md0.7 KB
View
rules/staging-z-index-hierarchy.md0.5 KB
View
rules/transition-style-pseudo-elements.md0.5 KB
View
rules/type-opentype-contextual-alternates.md0.3 KB
View
rules/type-underline-offset.md0.5 KB
View
rules/ux-fitts-target-size.md0.6 KB
View
rules/ux-pragnanz-simplify.md0.7 KB
View
rules/ux-zeigarnik-show-incomplete.md0.7 KB
View
rules/visual-shadow-direction.md0.7 KB
View
rules/type-text-wrap-pretty.md0.3 KB
View
rules/ux-fitts-hit-area.md0.5 KB
View
rules/ux-postels-accept-messy-input.md0.9 KB
View
rules/ux-von-restorff-emphasis.md0.8 KB
View
rules/visual-no-pure-black-shadow.md0.5 KB
View
rules/ux-cognitive-load-reduce.md1.1 KB
View
rules/ux-jakobs-familiar-patterns.md0.7 KB
View
rules/ux-serial-position.md0.7 KB
View
rules/visual-button-shadow-anatomy.md1.5 KB
View
rules/weight-match-action.md0.5 KB
View
rules/ux-hicks-minimize-choices.md0.9 KB
View
rules/ux-proximity-grouping.md0.6 KB
View
rules/visual-border-alpha-colors.md0.4 KB
View
rules/weight-duration-matches-action.md0.5 KB
View
rules/ux-millers-chunking.md0.5 KB
View
rules/ux-similarity-consistency.md0.6 KB
View
rules/visual-concentric-radius.md0.7 KB
View
rules/ux-uniform-connectedness.md1.0 KB
View
rules/visual-layered-shadows.md0.6 KB
View
rules/visual-shadow-matches-elevation.md0.5 KB
View

Install userinterface-wiki

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill