ask-emil

Hãy hỏi kỹ năng hoặc quy trình nào phù hợp với tình huống của bạn. Một bộ định tuyến cho các kỹ năng trong repo này.

npx skills add https://github.com/emilkowalski/skills --skill ask-emil

Ask Emil

Before stating what a skill does or recommending one, read that skill's SKILL.md: the summaries here are for orientation only. Then recommend one skill (or one short sequence) for the user's situation, say why in a sentence, and name the skill they'd reach for next. Don't list the whole map back at them.

A flow is a path through the skills. Most UI work travels one main flow, from idea to shipped. Some skills are upkeep you run on a codebase that already exists, some are references that sit underneath everything, and a few stand alone.

The main flow: idea → ship

  1. Not sure what it should look or feel like? Detour through /prototype. It builds several genuinely different versions behind a live picker, then promotes the one you pick into the real code. Reach for it whenever a design question is hard to settle in words.

  2. Build it. Pick the builder by what's moving:

    • /pick-ui-library first if the task needs a dependency (dropdown, dialog, toast, drawer, command menu, drag and drop, charts). Don't let the agent hand-roll a toast.
    • /animate for one animation on the web: whether to animate at all, then tool, properties, curve, duration, interruption, exit.
    • /choreograph when several elements move together: staggers, hero entrances, view swaps, an item leaving while siblings close the gap.
    • /gestures when the user's finger drives it: drag, swipe, sheets, snap points, swipe-to-dismiss.
    • /animate-expo for any of the above in React Native or Expo.
    • /ask-sonner when the work is toasts with Sonner.
  3. Try to break it. Before calling it done:

    • /break-ui feeds it worst-case data (long names, empty lists, huge counts, emoji, non-Latin text) behind a toggle and reports what broke.
    • /review-animations reviews the motion in the diff against a strict bar. Default to flagging; approval is earned.
    • /mobile-native if it runs on a phone as a web app: sticky hover, the 100vh bug, inputs that zoom, safe areas.
    • /animation-performance if anything drops frames.
  4. Learn from the session. /learn-taste closes the loop. Run it at the end, in the same session, before you clear: it collects every design correction you made (including edits you made yourself) and turns each into a rule with its why, so the next agent doesn't repeat the mistake.

Upkeep: a codebase that already exists

Not feature work. Run these when you have a spare moment, or when the app "feels off".

  • The motion needs work across the app → /improve-animations. Read-only: it audits every animation and writes prioritized, self-contained plans another agent (or a cheaper model) can execute.
  • It feels static → /find-animation-opportunities. Read-only: it proposes motion with exact values, and rejects everything that shouldn't move. Build the ones you accept with /animate.
  • It feels slow or over-animated → /remove-animations. Edits code, but only to subtract: motion on keyboard actions, high-frequency surfaces, decoration with no purpose.

These three cover different questions. If the user isn't sure which, ask whether the problem is bad motion, missing motion, or too much motion.

References underneath

Model-invoked skills the others lean on. Reach for them directly when the knowledge, not a process, is what's missing.

  • /emil-design-eng: the core philosophy for UI polish, component interactions, and the invisible details. The fallback when no narrower skill fits.
  • /apple-design: Apple's principles for interface design and fluid, physical motion, translated for the web.
  • /animation-vocabulary: when the problem is the word. "What's it called when…" turns a vague description into the exact term to prompt with.

Standalone

  • /write-swift: modern Swift, Swift 6 concurrency, and native iOS code. Off the web flow entirely.

Common situations

You sayReach for
"Animate this"/animate
"These should come in one after another"/choreograph
"It doesn't follow my finger"/gestures
"It stutters" / "it's janky"/animation-performance
"Does this animation feel right?"/review-animations
"Make the app feel better"/improve-animations
"What could animate here?"/find-animation-opportunities
"Too much is moving"/remove-animations
"Give me a few options"/prototype
"Which library should I use?"/pick-ui-library
"Works in Chrome, feels wrong on my phone"/mobile-native
"Try the worst case"/break-ui
"What's that bouncy thing called?"/animation-vocabulary
"Stop making that mistake"/learn-taste

Thêm skills từ emilkowalski

animate
emilkowalski
Xây dựng một hoạt ảnh từ đầu, đưa ra các quyết định theo thứ tự quyết định liệu nó có cảm giác đúng hay không — liệu nó có nên hoạt ảnh không, mục đích gì, công cụ nào, thuộc tính nào, đường cong và thời lượng nào, cách nó ngắt quãng, cách nó thoát. Viết phần triển khai. Sử dụng khi được yêu cầu tạo hoạt ảnh cho một thứ gì đó, thêm chuyển động, làm cho một thành phần trở nên sống động, hoặc xây dựng một chuyển tiếp. Để phê bình chuyển động hiện có, sử dụng review-animations; để kiểm tra toàn bộ mã nguồn, sử dụng improve-animations.
animate-expo
emilkowalski
Tạo hoạt ảnh trong React Native và Expo, đưa ra quyết định theo đúng thứ tự để xác định cảm giác chuyển động — có nên tạo hoạt ảnh hay không, chạy trên luồng nào, dùng thuộc tính nào, dùng spring hay timing, thao tác cử chỉ được chuyển giao ra sao và hoạt ảnh suy giảm như thế nào. Viết phần triển khai bằng Reanimated, Gesture Handler, Expo Router và expo-haptics. Dùng khi tạo hoạt ảnh cho bất kỳ thành phần nào trong ứng dụng Expo, thêm cử chỉ, sheet, chuyển cảnh màn hình, phản hồi khi nhấn hoặc phản hồi xúc giác, hay khắc phục chuyển động bị giật trên thiết bị. Dành cho...
developmentdesign
animation-performance
emilkowalski
Keep web animations inside the frame budget — animate composite-only properties, keep motion off the main thread when the page is busy, and find the cause when an animation drops frames. Use when an animation is janky, choppy, stutters, or drops frames; when choosing which property to animate; when deciding between CSS and JS animation on performance grounds; or when reaching for `will-change` or GPU layers. For choosing easing, duration, or whether to animate at all use animate; for...
developmentdesign
animation-vocabulary
emilkowalski
Từ điển tra ngược giúp chuyển đổi mô tả mơ hồ về một hiệu ứng hoạt hình hoặc chuyển động trên web thành thuật ngữ chính xác ("hiệu ứng nảy khi cửa sổ popover mở ra" → Pop in; "hiệu ứng cuộn đàn hồi kiểu iOS" → Rubber-banding). Sử dụng khi người dùng hỏi "hiệu ứng đó gọi là gì khi…", hoặc mô tả một hiệu ứng chuyển động mà không biết tên của nó và muốn có từ ngữ chính xác để gợi ý cho AI hoặc nhà thiết kế. Dùng để đặt tên cho hiệu ứng, không phải để thiết kế hay xây dựng hiệu ứng.
researchdesigncreative
apple-design
emilkowalski
Cách tiếp cận của Apple về thiết kế giao diện và chuyển động vật lý mượt mà, được chuyển thể cho web. Sử dụng khi xây dựng hoặc đánh giá giao diện điều khiển bằng cử chỉ, hoạt ảnh lò xo, tương tác kéo/vuốt/bảng, động lượng và chuyển tiếp có thể ngắt, vật liệu trong suốt và chiều sâu, kiểu chữ (cỡ chữ quang học, tracking, leading), chế độ giảm chuyển động, hoặc các nền tảng thiết kế (phản hồi, nhất quán không gian, tiết chế) đằng sau giao diện kiểu Apple.
ask-sonner
emilkowalski
Hướng dẫn về Sonner, thư viện toast của React — cài đặt và kết nối Toaster, chọn đúng lệnh gọi toast(), toast promise và loading, cập nhật, đóng và duy trì toast, tạo kiểu, chủ đề và biểu tượng, định vị và nhiều toaster. Sử dụng khi làm việc với Sonner hoặc khắc phục sự cố — toast không xuất hiện, xuất hiện hai lần, mất kiểu dáng, bỏ qua lớp Tailwind, nằm sau modal, hoặc không theo chế độ tối.
break-ui
emilkowalski
Thử làm hỏng một phần giao diện bằng cách đưa vào dữ liệu ở trường hợp xấu nhất — tên dài, email không thể ngắt dòng, tên chỉ có một chữ cái, trường bị thiếu, số lượng cực lớn, không có mục nào, nhãn dài, văn bản phi Latin, emoji, số cực lớn — sau đó hiển thị giao diện với công tắc "Demo data / Worst case" và báo cáo mọi thứ bị lỗi, kèm cách khắc phục cho từng lỗi. Dùng khi người dùng yêu cầu kiểm thử sức chịu đựng, làm hỏng hoặc tìm các trường hợp biên trong một thành phần hay màn hình, hoặc yêu cầu "thử trường hợp xấu nhất". Để phê bình thiết kế trực quan, dùng emil-design-eng; để xử lý chuyển động...
testingdesigndevelopment
choreograph
emilkowalski
Phối hợp nhiều thành phần chuyển động cùng nhau — quyết định thành phần nào di chuyển, theo thứ tự nào, chồng lấp bao nhiêu và thành phần nào đứng yên — để cả nhóm tạo thành một chuyển động có chủ đích thay vì một mớ hoạt ảnh riêng lẻ. Dùng khi xây dựng hoặc sửa danh sách xuất hiện lần lượt, hiệu ứng mở đầu của hero, chuyển đổi khung nhìn bên trong một vùng chứa, quy trình nhiều bước, một thành phần rời đi trong khi các thành phần cùng cấp thu hẹp khoảng cách, chuyển hình giữa các trạng thái phong phú hoặc bất kỳ tương tác nào có nhiều bộ phận chuyển động (biểu tượng + nền + đường kẻ, bảng điều khiển +...
designdevelopment