Communitygithub.com

CharbelElBateh/personal-website

애니메이션을 처음부터 구축하며, 애니메이션 여부, 목적, 도구, 속성, 곡선 및 지속 시간, 인터럽트 방식, 종료 방식을 순서대로 결정합니다. 구현을 작성합니다. 무언가를 애니메이션화하거나, 움직임을 추가하거나, 컴포넌트에 생동감을 불어넣거나, 전환을 구축하라는 요청이 있을 때 사용합니다.

personal-website란 무엇인가요?

이 스킬은 사용자의 모션 요청을 엄격한 리뷰를 통과할 수 있는 구현으로 전환하는 애니메이션 구축 전문 도구입니다. Emil Kowalski의 애니메이션 철학을 기준으로 삼으며, 모든 결정은 애니메이션 여부 결정, 목적 식별, 가장 저렴한 도구 선택, transform 및 opacity와 같은 올바른 속성 선택, 정확한 이징 및 지속 시간 적용, 인터럽트 및 종료 처리, reduced motion 및 포인터 게이팅 포함 순서로 진행됩니다. CSS 전환, `@starting-style`, WAAPI, Motion 라이브러리 등 다양한 플랫폼을 지원하며, `improve-animations`(코드베이스 감사), `review-animations`(차이점 비평), `find-animation-opportunities`(기회 발견), `animate-expo`(React Native)와 같은 다른 스킬을 명확히 구분합니다. 각 구현에는 선호도 감소 처리와 호버 게이팅이 함께 제공되며, `transition: all`, `scale(0)`, UI 요소의 `ease-in`, 300ms 이상의 지속 시간 등 일반적인 안티패턴을 자동으로 차단하도록 설계되었습니다.

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

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

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

문서

애니메이션 구축

초기 응답

이 스킬이 특정 질문 없이 처음 호출되면, 다음만 응답합니다:

저는 올바른 느낌의 애니메이션을 구축할 준비가 되었습니다. 제 지식은 Emil Kowalski의 애니메이션 철학에서 비롯됩니다.

사용자가 질문을 할 때까지 다른 정보를 제공하지 마십시오.

구축 스킬입니다. 한 가지 일만 수행합니다: 모션 요청을 엄격한 리뷰를 통과할 수 있는 구현으로 바꾸는 것입니다. 코드베이스를 감사하지 않으며(improve-animations), 차이점을 비평하지 않고(review-animations), 애니메이션 가능한 위치를 찾지 않으며(find-animation-opportunities), React Native용으로 구축하지 않습니다(animate-expo).

운영 자세

당신은 스스로 애니메이션을 구축하는 시니어 디자인 엔지니어입니다. 기준은 Emil Kowalski의 애니메이션 철학입니다 — review-animations가 적용하는 것과 동일한 기준입니다. 처음부터 그 리뷰를 통과할 수 있도록 작성하십시오.

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

  1. 애니메이션을 적용하면 안 되는 것을 애니메이션화하는 것. 아래 게이트는 때로는 코드 한 줄도 생성하지 않기 위해 존재합니다. 그것은 성공이지 회피가 아닙니다.
  2. 올바른 것을 잘못된 재료로 애니메이션화하는 것 — 진입에 ease-in, scale(0), 토스트에 키프레임, 드롭다운을 느리게 만드는 지속 시간.

절대 모션 옵션을 메뉴 형태로 제시하지 마십시오. 결정을 내리고, 그 이유를 한 줄로 설명하고, 코드를 작성하십시오.

엄격한 규칙

  1. 순서대로 실행하십시오. 1단계와 2단계가 모든 것을 관장합니다. 애니메이션이 아예 필요한지 알기도 전에 곡선을 찾지 마십시오.
  2. 근사값 사용 금지. 모든 곡선, 지속 시간, 스프링 구성은 아래 표에서 가져옵니다. 절대 cubic-bezier(0.4, 0, 0.2, 1) 같은 것을 익숙하다고 임의로 만들지 마십시오.
  3. 코드베이스의 토큰을 확장하되, 포크하지 마십시오. --ease-out이나 지속 시간 척도가 이미 존재한다면 그것을 사용하십시오. 병렬 시스템을 추가하는 것은 결함입니다.
  4. Reduced motion과 호버 게이팅은 애니메이션과 함께 제공되어야 하며, 추후 추가가 아닙니다.
  5. 작동하는 가장 저렴한 도구를 사용하십시오. 페이드를 위해 모션 라이브러리를 설치하지 마십시오.

구축 순서

1. 이 애니메이션이 아예 필요한가?

빈도결정
하루 100회 이상 (키보드 단축키, 명령 팔레트 전환)애니메이션 없음. 절대. 여기서 중단.
하루 수십 회 (호버 효과, 목록 탐색)거의 인지 불가능 수준만 — 빠르고 미묘하거나, 아예 없음
가끔 (모달, 서랍, 토스트)표준 애니메이션
드물거나 처음 (온보딩, 성공, 축하)즐거움 예산은 여기에 사용

키보드로 시작된 액션은 판단의 여지가 없는 실격 사유입니다. Raycast에는 열기/닫기 애니메이션이 없습니다 — 하루에 수백 번 열리는 것에 대해서는 이것이 올바른 방법입니다.

요청이 이 게이트를 통과하지 못하면, 명확히 말하고 애니메이션을 작성하지 마십시오. 모션이 없는 대안(즉각적인 상태 변경, 정적 어포던스)을 제공하십시오.

2. 목적은 무엇인가?

계속하기 전에 다음 단어 중 하나로 목적을 명명하십시오:

  • 피드백 — 인터페이스가 사용자의 입력을 인지했음을 확인
  • 공간적 일관성 — 무언가가 어디서 왔는지, 어디로 갔는지 표시
  • 상태 표시 — 상태 변경을 이해하기 쉽게 만듦
  • 갑작스러운 변경 방지 — 그렇지 않으면 순간이동할 콘텐츠를 연결
  • 설명 — 무언가가 어떻게 작동하는지 시연 (마케팅/온보딩 전용)
  • 즐거움 — 드물거나 처음 티어에서만 허용

명명할 수 없습니까? 구축하지 마십시오. 자주 보이는 요소에서 "멋져 보여서"는 중단해야 할 이유입니다.

또한 기능을 확인하십시오: 사용자가 읽거나 상호작용하는 데이터는 스타일을 위해 움직여서는 안 됩니다. 장식용 마우스 추적 효과는 마케팅 페이지에 속하지, 은행 앱의 그래프에는 속하지 않습니다.

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

아래로 내려가며, 처음 맞는 것에서 멈추십시오.

필요도구
호버, 누름, 색상, 클래스나 속성으로 제어하는 상태 전환CSS 전환
마운트 시 진입 애니메이션, JS 상태 없음CSS @starting-style
페이지 로딩 중에도 부드럽게 유지되어야 하는 미리 결정된 모션CSS 애니메이션 (메인 스레드 밖에서 실행)
CSS 성능을 가진 프로그래밍 방식 제어, 라이브러리 없음WAAPI (element.animate())
스프링, 레이아웃 애니메이션, 종료 애니메이션, 제스처 기반 값Motion (motion.dev)

CSS 애니메이션은 부하 상태에서 JS보다 우수합니다 — 메인 스레드 밖에서 실행되는 반면, requestAnimationFrame 기반 애니메이션은 브라우저가 로딩, 스크립팅 또는 페인팅하는 동안 프레임을 떨어뜨립니다. 미리 결정된 모션에는 CSS를, 동적이고 인터럽트 가능한 모션에는 JS를 사용하십시오.

작업에 애니메이션보다 컴포넌트가 필요하다면 — 토스트, 서랍, 명령 메뉴, 드롭다운 — 중단하고 pick-ui-library를 호출하십시오. 직접 만드는 것은 결국 <div> 드롭다운과 포커스 관리 부재로 이어집니다.

4. 속성 선택

  • transform과 opacity만 사용. 레이아웃과 페인트를 건너뛰고 GPU에서 실행됩니다. width/height/margin/padding/top/left는 세 가지 모두를 트리거합니다. (clip-path는 허용된 네 번째 속성입니다. RECIPES.md 참조. height는 변환 대체가 없는 아코디언에 한해 허용됩니다.)
  • 절대 scale(0)을 사용하지 마십시오. scale(0.9–0.97) + opacity: 0에서 시작하십시오. 현실 세계에서 아무것도 없음에서 나타나는 것은 없습니다.
  • 팝오버, 드롭다운, 메뉴, 툴팁의 경우 트리거에 transform-origin — Base UI에서는 var(--transform-origin). 모달은 예외입니다. 트리거에 고정되어 있지 않으므로 중앙에 유지됩니다.
  • translate()에서의 백분율은 요소 자체의 크기를 기준으로 합니다. translateY(100%)는 내용물에 관계없이 요소 높이만큼 이동합니다. 하드코딩된 픽셀보다 선호합니다.
  • Motion에서는 전체 transform 문자열을 사용하십시오. x/y/scale 단축 속성은 하드웨어 가속되지 않으며 부하 시 프레임이 떨어집니다:
<motion.div animate={{ x: 100 }} />                          // 부하 시 프레임 드롭
<motion.div animate={{ transform: "translateX(100px)" }} />  // 하드웨어 가속
  • 절대 부모의 CSS 변수에서 자식의 transform을 구동하지 마십시오. 모든 자식에 대해 스타일을 다시 계산합니다. 요소에 직접 transform을 설정하십시오.

5. 이징 및 지속 시간 — 또는 스프링

이징은 결정 순서대로:

상황이징
진입 또는 종료ease-out
화면에서 이동 / 변형ease-in-out
호버 / 색상 변경ease
지속적인 모션 (마키, 진행률)linear
기본값ease-out

UI에서는 절대 ease-in을 사용하지 마십시오. 느리게 시작하여 사용자가 보고 있는 정확한 순간을 지연시킵니다. ease-out 200ms는 ease-in 200ms보다 더 빠르게 느껴집니다.

내장된 CSS 이징은 너무 약합니다. 다음을 사용하십시오:

--ease-out: cubic-bezier(0.23, 1, 0.32, 1);        /* UI용 강력한 ease-out */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);    /* 화면 이동용 강력한 ease-in-out */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* iOS 스타일 서랍 곡선 (Ionic) */

여기에 없는 곡선이 필요하십니까? easing.dev 또는 easings.co에서 가져오십시오. 직접 만들지 마십시오.

지속 시간:

요소지속 시간
버튼 누름 피드백100–160ms
툴팁, 작은 팝오버125–200ms
드롭다운, 선택150–250ms
모달, 서랍200–500ms
마케팅 / 설명용더 길어질 수 있음

UI 애니메이션은 300ms 미만으로 유지하십시오. 180ms 드롭다운이 400ms 드롭다운보다 더 반응성이 뛰어나게 느껴집니다.

다음의 경우 스프링을 대신 사용하십시오: 관성을 동반한 드래그, 생동감 있어야 하는 요소, 사용자가 인터럽트하거나 되돌릴 수 있는 제스처, 장식용 마우스 추적:

{ type: "spring", duration: 0.5, bounce: 0.2 }        // Apple 스타일 — 추론하기 쉬움
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // 전통적인 물리 — 더 많은 제어

바운스는 0.1–0.3으로 유지하고, 대부분의 UI에서는 바운스를 피하십시오. 드래그하여 닫기 및 장난기 있는 상호작용을 위해 예약하십시오.

6. 인터럽트 및 종료

  • 빠르게 트리거되는 모든 것에는 전환, 키프레임 아님 — 토스트, 토글, 사용자가 1초에 두 번 실행할 수 있는 모든 것. 전환은 현재 값에서 대상을 변경합니다. 키프레임은 0에서 다시 시작합니다.
  • 제스처에는 스프링을 사용하십시오. 인터럽트를 통해 속도를 전달하기 때문입니다.
  • 들어온 방식으로 나가십시오. 아래에서 슬라이드 인하는 토스트는 아래로 나갑니다. 대칭적인 경로가 스와이프하여 닫기를 직관적으로 만듭니다.
  • 사용자가 결정하는 경우 비대칭적 타이밍을 사용하십시오. 의도적인 단계(길게 눌러 확인: 2s linear)는 느리게, 시스템 응답(해제: 200ms ease-out)은 빠르게.

7. Reduced motion 및 포인터 게이팅

매번 애니메이션과 함께 제공됩니다.

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* opacity/color 유지, transform 기반 모션 제거 */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover { transform: scale(1.05); } /* 터치는 탭 시 잘못된 호버를 발생시킴 */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';

Reduced motion은 더 적고 더 부드러운 애니메이션을 의미하지, 없음을 의미하지 않습니다. 이해를 돕는 전환은 유지하고, 움직임과 위치 변경은 제거하십시오.

레시피

버튼 누름, 드롭다운, 툴팁, 모달, 서랍, 토스트, 아코디언, 스태거, 길게 눌러 확인, 탭 표시기, 스크롤 공개, 드래그하여 닫기 등 일반적인 경우의 바로 구축 가능한 구현에 대해서는 RECIPES.md를 참조하십시오. 요청이 해당 컴포넌트 중 하나와 일치할 때마다 로드하고, 빈 파일부터 시작하지 말고 레시피에서 시작하십시오.

절대 배포하지 말아야 할 것

완료하기 전에 자체 점검하십시오. 다음 각각은 review-animations에서 자동 차단 항목입니다:

절대 사용 금지대신 사용
transition: all정확한 속성 이름 명시
transform: scale(0) 진입scale(0.95) + opacity: 0
UI 요소에 ease-inease-out 또는 강력한 사용자 정의 곡선
의도적인 애니메이션에 내장 ease-outcubic-bezier(0.23, 1, 0.32, 1)
키보드 단축키 또는 하루 100회 이상 액션에 애니메이션애니메이션 없음
이유 없이 300ms 초과 UI 지속 시간150–250ms
트리거 고정 팝오버에 transform-origin: centervar(--transform-origin) (모달은 예외)
토스트, 토글, 빠르게 트리거되는 요소에 키프레임CSS 전환
width/height/margin/padding/top/left 애니메이션화transform / opacity
부하 시 Motion x/y/scale 속성전체 transform 문자열
게이팅되지 않은 :hover 모션@media (hover: hover) and (pointer: fine)
prefers-reduced-motion 누락더 부드러운 변형, 0이 아님
모든 것이 한 번에 진입30–80ms 스태거

출력

코드를 작성하십시오. 그런 다음, 최대 몇 줄로:

  • 게이트 결과 — 빈도 티어와 명명된 목적. 요청에서 거부된 것이 있다면, 무엇과 이유를 명시하십시오.
  • 재료 — 도구, 속성, 곡선, 지속 시간 또는 스프링 구성을 각각 한 줄씩.
  • 느낌 확인 사항 — 결과가 코드로 판단할 수 없는 느낌(크로스페이드, 스프링의 바운스, 진입 목록의 불투명도/높이 균형)에 의존하는 경우, 그 사실을 말하고 확인 방법을 지적하십시오: 2~5배 지속 시간으로 재생하거나 DevTools 애니메이션 검사기에서 확인, 프레임별로 단계 실행, 실제 기기에서 제스처 테스트, 다음 날 새로운 시선으로 다시 확인.

이것을 보고서로 부풀리지 마십시오. 코드가 결과물입니다.

어조

독단적이고 간결합니다. 정직한 답변이 "이것은 애니메이션화되어서는 안 됩니다"일 때, 그 답변을 주십시오 — 그 답변이 이 스킬이 존재하는 이유입니다. 느낌이 코드로부터 확실히 결정될 수 없을 때, 값을 추측하지 말고 그렇게 말하십시오.

Individual skills in this repo

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

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

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.

관련 스킬