OpenParable
Skip to content
← Back to skills

Emil Design Engineering

Design
emil-design-engineering

Emil Design Engineering is an Agent Skill for design published in the Asymmetric-al/core repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Design engineering principles and patterns for building polished, accessible web interfaces. Use this skill when building UI components, reviewing frontend code, implementing forms, handling touch interactions, optimizing performance, or creating marketing pages. Triggers on: design engineering, UI polish, input fields, form validation, button states, touch devices, mobile UX, accessibility, a11y, keyboard navigation, aria labels, font rendering, typography, layout shift, z-index, animations, transitions, easing, hover effects, tap targets, iOS Safari, prefers-reduced-motion, marketing pages, landing pages, dark mode, theme switching, scrollbars, gradients, shadows, virtualization, preloading.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Asymmetric-al/core/blob/HEAD/.claude/skills/emil-design-engineering/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/emil-design-engineering, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Emil's Design Engineering Principles

A comprehensive guide for building polished, accessible web interfaces based on Emil Kowalski's design engineering practices.

Quick Reference

CategoryWhen to Use
AnimationsEnter/exit transitions, easing, springs, performance
UI PolishTypography, visual design, layout, colors
Forms & ControlsInputs, buttons, form submission
Touch & AccessibilityMobile, touch devices, keyboard nav, a11y
Component DesignCompound components, composition, props API
MarketingLanding pages, blogs, docs sites
PerformanceVirtualization, preloading, optimization
Design RulesPaired right/wrong calls across icons, type, color, IA, interaction, copy

Core Principles

1. No Layout Shift

Dynamic elements should cause no layout shift. Use hardcoded dimensions, font-variant-numeric: tabular-nums for changing numbers, and avoid font weight changes on hover/selected states.

2. Touch-First, Hover-Enhanced

Design for touch first, then add hover enhancements. Disable hover effects on touch devices. Ensure 44px minimum tap targets. Never rely on hover for core functionality.

3. Keyboard Navigation

Tabbing should work consistently. Only allow tabbing through visible elements. Ensure keyboard navigation scrolls elements into view with scrollIntoView().

4. Accessibility by Default

Every animation needs prefers-reduced-motion support. Every icon button needs an aria label. Every interactive element needs proper focus states.

5. Speed Over Delight

Product UI should be fast and purposeful. Skip animations for frequently-used interactions. Marketing pages can be more elaborate.

Decision Flowcharts

Should I Animate This?

Will users see this 100+ times daily?
├── Yes → Don't animate
└── No
    ├── Is this user-initiated?
    │   └── Yes → Animate with ease-out (150-250ms)
    └── Is this a page transition?
        └── Yes → Animate (300-400ms max)

What Easing Should I Use?

Is the element entering or exiting?
├── Yes → ease-out
└── No
    ├── Is it moving on screen?
    │   └── Yes → ease-in-out
    └── Is it a hover/color change?
        ├── Yes → ease
        └── Default → ease-out

Common Mistakes

MistakeFix
transition: allSpecify exact properties
Hover effects on touchUse @media (hover: hover)
Font weight change on hoverUse consistent weights
Animating height/widthUse transform and opacity only
No reduced motion supportAdd prefers-reduced-motion query
z-index: 9999Use fixed scale or isolation: isolate
Custom page scrollbarsOnly customize scrollbars in small elements

Review Checklist

When reviewing UI code, check:

  • No layout shift on dynamic content
  • Animations have reduced motion support
  • Touch targets are 44px minimum
  • Hover effects disabled on touch devices
  • Keyboard navigation works properly
  • Icon buttons have aria labels
  • Forms submit with Enter/Cmd+Enter
  • Inputs are 16px+ to prevent iOS zoom
  • No transition: all
  • z-index uses fixed scale

Reference Files

For detailed guidance on specific topics: