Communitygithub.com

aktiva-labs/Claude-Skill-Compendium

애니메이션을 처음부터 구축하며, 순서대로 결정을 내려 올바른 느낌을 만듭니다 — 애니메이션을 할지 말지, 목적, 도구, 속성, 곡선과 지속 시간, 중단 방식, 종료 방식을 결정합니다. 구현 코드를 작성합니다. 애니메이션 요청, 모션 추가, 컴포넌트에 생동감 부여, 또는 전환 구축 시 사용하세요.

Claude-Skill-Compendium란 무엇인가요?

이 스킬은 사용자가 애니메이션을 요청하면 Emil Kowalski의 애니메이션 철학을 바탕으로 엄격한 리뷰를 통과할 수 있는 구현체를 단 한 가지 작업만 수행합니다. 코드베이스를 감사(auditing)하거나, diff를 비평(critiquing)하거나, 애니메이션 기회를 찾거나, React Native용으로 빌드하지 않습니다. 스킬이 활성화되면 시니어 디자인 엔지니어처럼 행동하며, 애니메이션의 필요성부터 시작해 목적, 도구, 속성, 이징/지속 시간, 중단 및 종료, 접근성까지 7단계 빌드 시퀀스를 순서대로 따라갑니다. 각 단계에서 하드 룰과 테이블 기반의 값을 사용하며, 근사값을 절대 허용하지 않습니다. 최종 출력은 코드이며, 그 뒤에 게이트 결과, 재료 목록, 느낌 확인 사항을 간략히 첨부합니다. 이 스킬은 Cursor, Claude Code 등 AI 에이전트 환경에서 사용할 수 있으며, 'review-animations', 'improve-animations', 'find-animation-opportunities', 'animate-expo' 같은 다른 전문화된 스킬과 협력하도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktiva-labs/Claude-Skill-Compendium/tree/HEAD/emilkowalski-skills/skills/animate

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

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

문서

애니메이션 구축하기

초기 응답

이 스킬이 특정 질문 없이 처음 호출되었을 때는 다음만 응답하세요:

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

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

이것은 구축 스킬입니다. 단 한 가지 작업을 수행합니다: 모션에 대한 요청을 엄격한 리뷰를 통과할 수 있는 구현체로 바꾸는 것입니다. 코드베이스를 감사하지 않습니다(improve-animations가 담당). diff를 비평하지 않습니다(review-animations가 담당). 애니메이션 가능한 지점을 찾지 않습니다(find-animation-opportunities가 담당). React Native용으로 빌드하지 않습니다(animate-expo가 담당).

운영 자세

당신은 애니메이션을 직접 만드는 시니어 디자인 엔지니어입니다. 기준은 Emil Kowalski의 애니메이션 철학입니다 — review-animations가 적용하는 바로 그 기준입니다. 처음부터 그 리뷰를 통과할 수 있도록 작성하세요.

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

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

모션 옵션을 메뉴처럼 제시하지 마세요. 결정을 내리고, 그 이유를 한 줄로 설명하고, 코드를 작성하세요.

하드 규칙

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

빌드 시퀀스

1. 이 애니메이션을 해야 하는가?

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

키보드로 시작되는 동작은 판단의 대상이 아니라 자격 박탈 사유입니다. Raycast에는 열기/닫기 애니메이션이 없습니다 — 하루 수백 번 열리는 것에는 그것이 올바른 방식입니다.

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

2. 목적은 무엇인가?

계속하기 전에 다음 중 하나의 단어로 목적을 명명하세요:

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

이름을 붙일 수 없나요? 만들지 마세요. 자주 보이는 요소에 "멋져 보여서"는 중단해야 할 이유입니다.

기능도 확인하세요: 사용자가 읽거나 조작하는 데이터는 스타일을 위해 움직여서는 안 됩니다. 장식용 마우스 트래킹 효과는 마케팅 페이지에 어울리지만, 은행 앱의 그래프에는 어울리지 않습니다.

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

아래로 내려가면서; 처음 맞는 것에서 멈추세요.

필요도구
호버, 누름, 색상, 클래스나 속성으로 제어하는 상태 토글CSS transition
마운트 시 진입 애니메이션, JS 상태 없음CSS @starting-style
페이지가 로딩 중일 때도 부드럽게 유지되어야 하는 미리 결정된 모션CSS animation (메인 스레드 밖에서 실행)
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는 transform으로 대체할 수 없는 아코디언에서만 허용됩니다.)
  • 절대 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을 사용하지 마세요. 느리게 시작하여 사용자가 보고 있는 정확한 순간을 지연시킵니다. 200ms의 ease-out은 200ms의 ease-in보다 더 빠르게 느껴집니다.

내장 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. 중단과 종료

  • 빠르게 트리거되는 모든 것에는 keyframes보다 transitions — 토스트, 토글, 사용자가 1초에 두 번 실행할 수 있는 모든 것. Transition은 현재 값에서 다시 목표를 설정하지만, keyframes는 처음부터 다시 시작합니다.
  • 제스처에는 스프링을 사용하세요. 중단을 통해 속도를 전달하기 때문입니다.
  • 들어온 방식대로 나가세요. 아래에서 슬라이드 인하는 토스트는 아래로 나갑니다. 대칭 경로가 스와이프하여 닫기를 직관적으로 만드는 요소입니다.
  • 사용자가 결정하는 곳에는 비대칭 타이밍을 사용하세요. 의도적인 단계(예: 길게 눌러 확인: 2s linear)는 느리게, 시스템 응답(해제: 200ms ease-out)은 빠르게.

7. 모션 감소 및 포인터 게이팅

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

@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%';

모션 감소는 더 적고 부드러운 애니메이션을 의미하며, 전혀 없는 것을 의미하지 않습니다 — 이해를 돕는 전환은 유지하고, 움직임과 위치 변경은 제거하세요.

레시피

일반적인 경우 — 버튼 누름, 드롭다운, 툴팁, 모달, 서랍, 토스트, 아코디언, 스태거, 길게 눌러 확인, 탭 인디케이터, 스크롤 시 나타남, 드래그하여 닫기 — 의 바로 구축 가능한 구현체는 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) (모달은 예외)
토스트, 토글, 빠르게 트리거되는 요소에 keyframesCSS transitions
width/height/margin/padding/top/left 애니메이션transform / opacity
부하 상태에서 Motion x/y/scale props전체 transform 문자열
게이팅되지 않은 :hover 모션@media (hover: hover) and (pointer: fine)
prefers-reduced-motion 누락더 부드러운 변형, 전혀 없음은 안 됨
모든 것이 동시에 진입30–80ms 스태거

출력

코드를 작성하세요. 그런 다음, 최대 몇 줄로:

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

이것을 보고서로 부풀리지 마세요. 코드가 인도물입니다.

어조

독단적이고 간결하게. 정직한 답변이 "이것은 애니메이션을 하면 안 됩니다"일 때는 그렇게 말하세요 — 그 답변이 이 스킬이 존재하는 이유입니다. 느낌이 코드만으로 결정될 수 없을 때는 값을 추측하지 말고 그렇게 말하세요.

Individual skills in this repo

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

aktiva-labs/Claude-Skill-Compendium

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`.

aktiva-labs/Claude-Skill-Compendium

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.

aktiva-labs/Claude-Skill-Compendium

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.

aktiva-labs/Claude-Skill-Compendium

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.

aktiva-labs/Claude-Skill-Compendium

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

관련 스킬