跳到正文
cccskills
免费在 GitHub 公开

emil-design-engineering

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.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(10)

  • SKILL.md5.5 KB
  • animations.md8.1 KB
  • component-design.md7.5 KB
  • design-rules.md19.3 KB
  • forms-controls.md5.0 KB
  • marketing.md3.5 KB
  • performance.md4.7 KB
  • references/upstream.md1.8 KB
  • touch-accessibility.md4.8 KB
  • ui-polish.md6.2 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

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:

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Audit and fix accessibility in Core UI. Use when changing or reviewing buttons, links, forms, validation, dialogs, menus, tabs, tables, keyboard interactions, focus management, accessible names, announcements, contrast, touch targets, reduced motion, or WCAG/a11y behavior.

中文简介正在准备中。当前显示原文说明。

Asymmetric-al/core3812026年10月21日 更新

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

中文简介正在准备中。当前显示原文说明。

Asymmetric-al/core3812026年10月21日 更新

Use when building any system where email content triggers actions — AI agent inboxes, automated support handlers, email-to-task pipelines, or any workflow processing untrusted inbound email. Always use this skill when the user wants to receive emails and act on them programmatically, even if they don't mention "agent" — the skill contains critical security patterns (sender allowlists, content filtering, sandboxed processing) that prevent untrusted email from controlling your system.

中文简介正在准备中。当前显示原文说明。

Asymmetric-al/core3812026年10月21日 更新

anim

免费

Tasteful, subtle web UI animation following Emil Kowalski / animations.dev principles. Use when adding or reviewing interface motion — hover and press feedback, entrances and exits, modals, toasts, menus, loading and skeleton states, staggered reveals, page or view transitions — so motion stays refined and purposeful, not decorative. Covers CSS, Web Animations, and React timing/easing. Pair with the motion skill for motion/react API specifics.

中文简介正在准备中。当前显示原文说明。

Asymmetric-al/core3812026年10月21日 更新

animate

免费

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations. Only runs when explicitly invoked; it does not trigger on its own.

中文简介正在准备中。当前显示原文说明。

Asymmetric-al/core3812026年10月21日 更新

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

中文简介正在准备中。当前显示原文说明。

Asymmetric-al/core3812026年10月21日 更新

查看 Asymmetric-al 的全部技能

报告此技能的问题