Communitygithub.com

CharbelElBateh/personal-website

React Native와 Expo에서 애니메이션을 구축하며, 실제 기기에서 자연스럽게 느껴지는 결정을 순서대로 내립니다—애니메이션 여부, 실행 스레드, 속성, 스프링 또는 타이밍, 제스처 핸드오프, 저하 방식. Reanimated, Gesture Handler, Expo Router 및 expo-haptics를 사용해 구현합니다. Expo 앱에서 애니메이션, 제스처, 시트, 화면 전환, 누름 피드백 또는 햅틱을 추가하거나 기기에서 끊김 없는 모션을 수정할 때 사용하세요. 웹 애니메이션에는 `animate`를 사용하세요.

personal-website란 무엇인가요?

이 스킬은 Expo와 React Native 애플리케이션에서 고품질 모바일 애니메이션을 구축하기 위한 전문 가이드입니다. 실제 기기, 특히 지원하는 가장 느린 기기에서 릴리스 빌드로 테스트했을 때 올바르게 느껴지는 애니메이션을 만드는 데 중점을 둡니다. 핵심 원칙은 호버가 없고, 두 개의 런타임(React Native와 UI 스레드)이 있으며, 사용자의 손가락이 요소 위에 있다는 것입니다. 이 스킬은 모든 애니메이션 결정에 대해 9단계 빌드 시퀀스를 제공하며, 애니메이션의 필요성 결정부터 시작하여 목적 정의, 적절한 도구와 속성 선택, 타이밍/스프링 구성, 제스처 처리, 햅틱 통합, 접근성 및 감소된 모션 지원에 이르기까지 다룹니다. Reanimated, Gesture Handler, Expo Router, expo-haptics, react-native-keyboard-controller, Lottie 및 Skia와 같은 라이브러리를 지원합니다. 각 결정에 대한 명확한 규칙과 구성 테이블을 제공하며, '아무것도 애니메이션하지 않음'이 올바른 선택일 때도 알려주어 모바일 애니메이션에 대한 실용적이고 성능 중심적인 접근 방식을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/animate-expo

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Expo에서 애니메이션 구축하기

초기 응답

이 스킬이 특정 질문 없이 처음 호출되면, 다음으로만 응답하세요:

실제 기기에서 올바르게 느껴지는 Expo 및 React Native 애니메이션을 구축할 준비가 되었습니다. 제 지식은 Emil Kowalski의 애니메이션 철학에서 비롯되었습니다.

사용자가 질문하기 전까지는 다른 정보를 제공하지 마세요.

React Native를 위한 구축 스킬입니다. 모션 요청을 실제 기기에서 엄격한 검토를 견딜 수 있는 구현으로 바꿉니다—시뮬레이터도, 개발 모드의 플래그십 폰도 아닙니다.

모바일은 애니메이션에 대해 세 가지를 바꾸며, 이 스킬의 모든 것은 이로부터 비롯됩니다:

  1. 호버가 없습니다. 웹이 호버에 두는 모든 어포던스는 누름, 위치 또는 아무것도 아닌 곳에 존재해야 합니다.
  2. 두 개의 런타임이 있습니다. Worklets (Reanimated 4)은 이를 명시적으로 만듭니다: React가 렌더링하고 앱 로직이 실행되는 React Native 런타임, 그리고 워크렛이 매 프레임 실행되는 UI 런타임(백그라운드 작업을 위한 선택적 워커 런타임 포함). RN 런타임을 건드리는 애니메이션은 앱이 다른 작업을 하는 순간 끊깁니다. 모든 기술은 모션을 UI 런타임에 유지하는 데 있습니다.
  3. 사용자의 손가락이 요소 위에 있습니다. 제스처가 기본 입력이므로, 중단 가능성과 속도 핸드오프는 폴리싱이 아닌 기본입니다.

운영 자세

당신은 직접 애니메이션을 구축하는 시니어 모바일 엔지니어입니다. 결정을 내리고, 한 줄로 추론을 설명하고, 코드를 작성하세요. 모션 옵션을 메뉴로 제시하지 마세요.

두 가지 실패 모드가 있으며, 첫 번째가 더 나쁩니다:

  1. 애니메이션해서는 안 되는 것을 애니메이션하는 것. 아래 게이트는 때로는 코드가 전혀 생성되지 않도록 존재합니다.
  2. 올바른 것을 잘못된 스레드에서 애니메이션하는 것 — 프레임당 setState, PanResponder, 애니메이션된 height. 개발 중인 폰에서는 괜찮아 보이지만 3년 된 Android에서는 20fps로 떨어집니다.

엄격한 규칙

  1. 순서대로 시퀀스를 실행하세요. 1단계와 2단계가 모든 것을 관장합니다.
  2. 핵심 Animated 대신 Reanimated. 핵심 Animated는 브리지를 건너지 않고는 제스처로 구동될 수 없으며, useNativeDriver는 어쨌든 transform과 opacity만 허용합니다. Reanimated 워크렛은 UI 스레드에서 실행되며 JS가 바쁜 동안에도 계속 실행됩니다.
  3. 근사값은 없습니다. 곡선과 스프링 구성은 아래 표에서 가져옵니다.
  4. 감소된 모션은 후속 작업이 아닌 애니메이션과 함께 제공됩니다.
  5. 느낌은 지원하는 가장 느린 기기에서 릴리스 빌드로 판단됩니다. 다른 어떤 것도 확인된 것으로 간주되지 않습니다.

빌드 시퀀스

1. 이게 정말 애니메이션되어야 하나요?

빈도결정
하루 100회 이상 — 탭 전환, 키보드 열기/닫기, 스크롤, 설정 토글애니메이션 없음. 플랫폼 기본값 또는 아무것도. 여기서 중단.
하루 수십 회 — 누름 피드백, 목록 탐색, 행 선택거의 감지되지 않을 정도만: 150ms 미만, 또는 아무것도
가끔 — 시트, 모달, 토스트, 온보딩 단계표준 애니메이션
드물게 / 처음 — 성공 상태, 빈 상태 일러스트레이션, 축하기쁨 예산은 여기에 있습니다

탭 전환은 절대 슬라이드하지 않습니다. 탭은 동료이며 계층 구조가 아닙니다 — 슬라이딩은 존재하지 않는 깊이를 암시하며, 사용자는 세션당 수십 번 그 비용을 지불합니다. animation: 'none'.

요청이 이 게이트를 통과하지 못하면 그렇게 말하고 작성하지 마세요.

2. 목적은 무엇인가요?

계속하기 전에 한 단어로 이름을 지정하세요: 피드백, 공간 일관성, 상태 표시, 갑작스러운 변경 방지, 설명, 또는 기쁨 (드문 계층만).

이름을 지을 수 없나요? 구축하지 마세요.

3. 도구 선택 — 가장 저렴하면서 작동하는 것

아래로 내려가며; 맞는 첫 번째에서 멈추세요.

필요도구
제스처가 없는 상태 기반 변경 — 누름, 토글, 색상, 값 변경Reanimated CSS 전환 (스타일의 transitionProperty)
루프, 다단계, 또는 상태 변경 없이 마운트 시 재생Reanimated CSS 애니메이션 (animationName 키프레임)
요소 마운트/언마운트, 또는 목록 재배치레이아웃 애니메이션 (entering / exiting / itemLayoutAnimation)
손가락이 닿는 모든 것, 또는 스크롤에서 파생된 모든 것useSharedValue + Gesture + useAnimatedStyle
화면 간Expo Router의 네이티브 스택 옵션. 절대 수동 구현하지 마세요
자체 화면인 바텀 시트presentation: 'formSheet' — 실제 UISheetPresentationController이며, 무료이고 정확합니다
탭 바NativeTabs (expo-router/unstable-native-tabs에서) — 플랫폼의 실제 탭 바, 그 동작과 전환 포함
컨텍스트 메뉴, 길게 누름 미리보기Link.Menu / Link.Preview (Expo Router, iOS 전용) — 네이티브 메뉴와 픽, JS에서 절대 재구축하지 않음
큰 제목으로 축소되는 헤더headerLargeTitleEnabled (네이티브 스택에서, iOS 전용; headerLargeTitle는 더 이상 사용되지 않음) — 스크롤 워크렛이 아님
당겨서 새로고침RefreshControl — 시그니처 상호작용인 경우에만 수동 구현 (임계값 레시피 참조)
키보드를 따라가는 UIreact-native-keyboard-controller — 키보드의 실제 위치를 UI 스레드에서 프레임별로 제공
벡터 일러스트레이션, 축하, 빈 상태Lottie — 일러스트레이션 전용, 절대 UI 상태용 아님
거대한 애니메이션 장면, 자유형 드로잉@shopify/react-native-skia — 뷰 계층 구조 자체가 병목일 때를 위한 캔버스

값이 연속적이거나 중단 가능할 때만 공유 값에 도달하세요. 누름 크기는 CSS 전환이고, 드래그는 공유 값입니다. 2상태 토글에 워크렛을 사용하는 것은 페이드 인을 위해 모션 라이브러리를 설치하는 모바일 버전입니다.

의존성. npx expo install <package>로 설치하세요 — 프로젝트 SDK와 일치하는 버전을 해결하며, 일반 npm install은 그렇지 않습니다:

필요패키지
애니메이션react-native-reanimated + react-native-worklets
제스처react-native-gesture-handler
내비게이션, 시트, 네이티브 탭, 메뉴expo-router
햅틱expo-haptics
키보드 추적 UIreact-native-keyboard-controller (루트에 KeyboardProvider 필요 — 키보드 레시피 참조)
일러스트레이션, 축하lottie-react-native
매우 큰 애니메이션 장면, 사용자 정의 드로잉@shopify/react-native-skia

4. 속성 선택

  • transform과 opacity는 무료입니다. 그 외의 모든 것은 레이아웃 패스입니다. width, height, margin, padding, flex, top, left, gap은 해당 노드 와 그 형제에 대해 매 프레임마다 Yoga를 다시 실행합니다.
  • 하나의 예외: 자식이 없는 절대 위치 요소 — 탭 알약, 진행률 표시줄 채움. 흐름 밖이므로 다른 것이 재배치되지 않으며, width를 애니메이션하면 scaleX가 흐릴 코너 반경이 유지됩니다.
  • 절대 scale(0)을 사용하지 마세요. scale(0.9–0.97) + opacity: 0에서 시작하세요. 현실 세계에서 아무것도 무에서 나타나지 않습니다.
  • transform은 배열이며 순서가 중요합니다 — [{ translateY }, { scale }]는 이동 후 크기를 조정합니다; 반대면, translate도 크기 조정됩니다. 곱셈을 원하지 않으면 translate를 먼저 유지하세요.
  • Android 그림자는 elevation이며, elevation을 애니메이션하면 매 프레임 그림자를 다시 렌더링합니다. 대신 미리 그림자가 적용된 레이어의 opacity를 애니메이션하세요.
  • 절대 BlurView 강도를 애니메이션하지 마세요. Android에서는 매 프레임 블러를 다시 렌더링합니다. 대신 정적 BlurView의 opacity를 크로스페이드하세요.
  • 백분율은 translate에서 작동하며 요소 자체 크기에 상대적입니다 — translateY('100%')는 콘텐츠와 관계없이 시트를 자체 높이만큼 이동시킵니다.

5. 타이밍 또는 스프링

손가락이 관여했다면 스프링을 사용하세요. 스프링은 중단을 통해 속도를 전달합니다; 타이밍 곡선은 재시작합니다. 그 외의 모든 것은 타이밍을 사용합니다.

Reanimated의 스프링은 Apple의 두 디자이너 매개변수를 직접 사용합니다 — 이 형식을 사용하고, mass/stiffness/damping은 사용하지 마세요:

상호작용구성
기본 안정, 오버슈트 없음{ duration: 400, dampingRatio: 1 }
드래그 후 재배치/스냅백{ duration: 400, dampingRatio: 0.8, velocity }
시트, 서랍{ duration: 300, dampingRatio: 0.8, velocity }
하드 엣지를 넘지 않아야 함overshootClamping: true 추가

제스처가 운동량을 전달했을 때만 바운스하세요. 페이드 인된 메뉴의 오버슈트는 잘못 느껴집니다; 당신이 튕긴 카드의 오버슈트는 올바르게 느껴집니다.

이징, 손가락이 없는 모든 것의 경우:

상황이징
들어오거나 나가기ease-out
화면에서 이동/변형ease-in-out
일정한 모션 (진행률, 마키)linear
기본값ease-out

UI에 절대 ease-in을 사용하지 마세요. 느리게 시작하여 사용자가 보고 있는 정확한 순간을 지연시킵니다. Reanimated의 내장 이징은 CSS만큼 약합니다 — 이것들을 사용하세요:

import { Easing } from 'react-native-reanimated';

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // UI를 위한 강한 ease-out
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1);  // 화면 내 움직임
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1);    // iOS 시트 곡선

지속 시간:

요소지속 시간
누름 피드백100–150ms
토글, 칩, 작은 상태 변경150–200ms
시트, 모달, 서랍스프링, ~300ms 인지
화면 전환플랫폼 기본값 — 재정의하지 마세요

모바일 UI 애니메이션은 웹과 마찬가지로 300ms 미만으로 유지됩니다. 플랫폼 자체 전환은 더 깁니다(iOS 푸시는 350ms); 내비게이션에서는 플랫폼을 따르고, 다른 모든 곳에서는 이를 능가하세요.

6. JS 스레드에서 멀리 유지하세요

이것이 모바일 특화 기술이며, 대부분의 React Native 모션이 죽는 곳입니다.

  • 제스처 또는 스크롤 핸들러에서 절대 setState를 사용하지 마세요. 프레임당 하나의 React 렌더링은 RN 앱에서 지연의 가장 큰 원인입니다. 공유 값 → useAnimatedStyle, React는 전혀 다시 렌더링하지 않습니다.
  • onUpdate 또는 스크롤 핸들러 내에서 RN 런타임으로 다시 예약하지 마세요. react-native-worklets의 scheduleOnRN(fn, ...args) — 더 이상 사용되지 않는 runOnJS(fn)(...args)를 대체하는 Reanimated 4 — 는 RN 런타임 호출을 큐에 넣으며, onUpdate에서는 초당 60–120회입니다. 이는 onEnd에 속하거나, 값이 임계값을 넘을 때 실행되는 useAnimatedReaction에 속합니다.
  • 렌더링 중에 공유 값을 읽지 마세요 (JSX에서 translateY.get()). 절대 업데이트되지 않는 스냅샷이며 조용히 동기화가 깨집니다. 렌더링 중에 값을 쓰지도 마세요 — 재조정 중간에 실행되며, 사용자가 일으키지 않은 리렌더링이 쓰기를 재생합니다. 워크렛, 핸들러 및 이펙트에서만 공유 값을 다루세요.
  • .get() / .set()을 사용하고, .value를 사용하지 마세요. 동일한 API이지만, 직접 .value 접근은 React Compiler가 볼 수 없는 형식입니다 — Reanimated 문서는 get/set을 컴파일러 안전 방식이라고 부릅니다. set은 또한 함수형 업데이트를 받습니다: sv.set((v) => v + 1).
  • 워크렛에서 호출되는 함수는 첫 번째 줄에 'worklet' 이 필요합니다. 그렇지 않으면 디버거에서는 잘 작동하지만 기기에서 런타임에 오류가 발생합니다.

7. 누름, 호버가 아님

웹의 모든 호버 어포던스는 포팅되지 않고 재설계되어야 합니다.

  • 누름-인 시 피드백, 누름-아웃 시 커밋. 탭이 완료될 때까지 아무것도 표시하지 않으면 죽은 것처럼 느껴집니다 — 이것이 사용자가 실제로 인지하는 지연 시간입니다.
  • 누를 수 있는 모든 것에 대해 100–150ms 내에 scale: 0.97 , Pressable + CSS 전환. scale은 레이블과 아이콘을 함께 가져가며, 이것이 물리적으로 읽히게 만듭니다.
  • 44×44pt 최소 터치 타겟 (48dp Android). 시각적 요소가 더 작으면 hitSlop을 추가하세요 — 시각적 요소를 키우지 마세요.
  • pressRetentionOffset 로 손가락이 몇 픽셀 벗어나도 사용자가 의도한 누름이 취소되지 않도록 합니다.
  • Android 리플은 Material 스타일 앱에서만 사용하세요. 사용자 정의 디자인 앱에서는 두 플랫폼에서 동일한 스케일이 한쪽에 리플을 사용하는 것보다 더 일관성이 있습니다.

8. 햅틱

모바일에는 웹에는 없는 감각이 있습니다. 드물게 사용하면 앱을 고급스럽게 느끼게 만드는 요소가 됩니다; 모든 곳에 사용하면 사용자가 꺼버립니다.

순간호출
값이 단계를 지나칠 때 — 피커, 슬라이더 디텐트, 분할 컨트롤Haptics.selectionAsync()
무언가가 제자리에 스냅될 때, 시트 디텐트가 걸릴 때, 드래그가 커밋될 때Haptics.impactAsync(ImpactFeedbackStyle.Light)
무거운 물체가 착지할 때, 파괴적인 동작이 실행될 때Haptics.impactAsync(ImpactFeedbackStyle.Medium)
작업 성공 또는 실패Haptics.notificationAsync(NotificationFeedbackType.Success / Error)

세 가지 규칙이며 절대적입니다:

  • 시각과 같은 프레임에. 애니메이션보다 늦는 햅틱은 피드백이 아닌 결함으로 읽힙니다. 인과적 순간에 실행하세요 — 디텐트가 걸릴 때 — 애니메이션이 끝날 때가 아닙니다.
  • 사용자 동작당 하나. 스크롤 시 절대, 프레임당 절대, 사용자가 일으키지 않은 진입 애니메이션 시 절대 사용하지 마세요.
  • 절대 유일한 피드백이 되어서는 안 됩니다. 많은 사용자에게 햅틱은 시스템 전체에서 꺼져 있으며, 대부분의 Android 하드웨어에서는 무음입니다. 시각적 요소는 단독으로 작동해야 합니다.

워크렛에서 햅틱은 RN 런타임으로 다시 예약되어야 합니다: scheduleOnRN(Haptics.selectionAsync).

9. 감소된 모션 및 접근성

import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';

const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);

// 또는 각 애니메이션이 결정하도록
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });

감소된 모션은 더 적고 부드럽게를 의미하며, 0이 아닙니다: 상태 변경을 설명하는 opacity 및 색상 변경은 유지하고, 변환, 스케일, 시차 및 오버슈트는 제거하세요. 화면 전환은 animation: 'fade'가 됩니다.

텍스트 스케일. allowFontScaling은 기본적으로 켜져 있으므로, 기본 유형 크기에서 측정한 모든 높이는 200%에서 잘못됩니다. 절대 하드코딩된 높이로 애니메이션하지 마세요 — onLayout으로 측정하거나, 대신 변환을 애니메이션하세요.

조용히 모션을 망가뜨리는 설정

"애니메이션이 실행되지 않습니다"라는 경우 먼저 이것들을 확인하세요:

  • Expo를 통해 SDK 버전과 일치하도록 설치: npx expo install react-native-reanimated react-native-worklets. Expo 프로젝트에서는 babel-preset-expo가 자동으로 worklets Babel 플러그인을 구성합니다 — babel.config.js 단계가 필요 없습니다. 해당 프리셋이 없는 일반 RN 프로젝트만 플러그인을 수동으로 추가하며, Expo Router를 사용한다면 이미 포함되어 있습니다.
  • react-native-reanimated/plugin은 Expo Router babel.config.js의 module.exports 아래에, 프리셋 앞에 있으며, 함수형 내보내기 구문을 사용합니다: api.cache(true); return { presets: ['babel-preset-expo'], plugins: ['react-native-reanimated/plugin'] };
  • iOS에서 npx expo run:ios는 네이티브 모듈을 다시 빌드합니다. npx expo start --clear는 Metro와 Reanimated의 워크렛을 다시 설정합니다.
  • Reanimated 3에서 마이그레이션할 때: Reanimated 4는 react-native-worklets를 분리했습니다. withDecay가 없어졌으며, withClamp가 이를 대체했습니다. useDerivedValue는 react-native-worklets의 useSharedValue에서 텍스트 패스와 같습니다: 한 번에 하나의 함수를 매핑하려면 map((v) => ...)를 사용하세요.
  • react-native-gesture-handler는 GestureDetector 아래에 단일 자식만 감쌉니다 — 추가 View 래퍼가 감지기를 깨뜨립니다.
  • 하나의 제스처에서 축소와 팬을 동시에 하려면 Gesture.Simultaneous(pan, pinch)를 사용하고, Gesture.Exclusive(pan, pinch)는 시작된 쪽을 우선시합니다.

레시피: 누름 스케일

import { StyleSheet, Pressable } from 'react-native';

// Reanimated CSS 전환을 위한 스타일 — 많은 보일러플레이트 없음
<Pressable
  style={({ pressed }) => [
    styles.button,
    { transform: [{ scale: pressed ? 0.97 : 1 }] },
  ]}
  onPress={handlePress}>
  <Text>누르기</Text>
</Pressable>
/* 스타일시트 */
.button {
  transition-property: transform;
  transition-duration: 100ms;
  transition-timing-function: ease-out;
}

레시피: 드래그 가능한 카드

import { Gesture, GestureDetector } from 'react-native-gesture-handler';
import Animated, { useSharedValue, useAnimatedStyle, withSpring } from 'react-native-reanimated';

function DraggableCard() {
  const offset = useSharedValue(0);
  const start = useSharedValue(0);

  const pan = Gesture.Pan()
    .onStart(() => { start.value = offset.value; })
    .onUpdate((e) => { offset.value = start.value + e.translationY; })
    .onEnd((e) => {
      offset.value = withSpring(0, { duration: 400, dampingRatio: 0.8, velocity: e.velocityY });
    });

  const animatedStyle = useAnimatedStyle(() => ({
    transform: [{ translateY: offset.value }],
  }));

  return (
    <GestureDetector gesture={pan}>
      <Animated.View style={[styles.card, animatedStyle]}>
        <Text>드래그 가능</Text>
      </Animated.View>
    </GestureDetector>
  );
}

레시피: 시트 디텐트

import { router } from 'expo-router';

// 파일: app/sheet.tsx
// 사용: router.push('/sheet')
// 앱에서 링크: <Link href="/sheet" asChild>

export default function Sheet() {
  return (
    <View>
      <Text>시트</Text>
    </View>
  );
}
// app/_layout.tsx
import { Stack } from 'expo-router';

export default function Layout() {
  return (
    <Stack>
      <Stack.Screen name="sheet" options={{ presentation: 'formSheet' }} />
    </Stack>
  );
}

레시피: 키보드 추적

// app/_layout.tsx — KeyboardProvider로 루트 레이아웃 감싸기
import { KeyboardProvider } from 'react-native-keyboard-controller';

export default function RootLayout({ children }) {
  return <KeyboardProvider>{children}</KeyboardProvider>;
}
// 뷰 아래 컴포넌트에서
import Animated, { useAnimatedKeyboard, useAnimatedStyle } from 'react-native-keyboard-controller';

function ChatBar() {
  const keyboard = useAnimatedKeyboard();

  const animatedStyle = useAnimatedStyle(() => ({
    transform: [{ translateY: -keyboard.height.value }],
  }));

  return <Animated.View style={[styles.chatBar, animatedStyle]} />;
}

레시피: 스프링 트랜지션

import Animated, { useAnimatedStyle, withSpring } from 'react-native-reanimated';
import { useSharedValue } from 'react-native-worklets';

function Toggle() {
  const active = useSharedValue(false);

  const animatedStyle = useAnimatedStyle(() => ({
    transform: [{ scale: withSpring(active.value ? 0.97 : 1, { duration: 200, dampingRatio: 1 }) }],
  }));

  return (
    <Pressable onPress={() => active.set((v) => !v)}>
      <Animated.View style={[styles.toggle, animatedStyle]} />
    </Pressable>
  );
}

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

관련 스킬