Communitygithub.com

모션 크래프트

GPU 가속 애니메이션을 Web Animations API(WAAPI), 스크롤 기반 애니메이션(ScrollTimeline/ViewTimeline), FLIP 기법, 이징 시스템, 접근성(prefers-reduced-motion)을 활용하여 설계합니다. 사용자가 웹 UI 애니메이션, 전환, 스크롤 효과, 페이지 전환, 인터랙티브 모션을 요청할 때 사용하세요. 캔버스 기반 애니메이션(Three.js, PixiJS), 비디오 편집, 비웹(네이티브 모바일) 모션 디자인에는 사용하지 마세요.

모션 크래프트란 무엇인가요?

모션 크래프트는 커뮤니케이션을 위한 애니메이션을 설계하는 AI 에이전트 기술입니다. 불필요한 움직임 없이 모든 프레임이 그 자리를 차지해야 한다는 철학을 기반으로 합니다. 이 기술은 Emil Kowalski(Linear, Sonner, Vaul), Paul Lewis(Google Chrome), CSS Animation Working Group에서 영감을 받았습니다. 모션 크래프트는 4단계 애니메이션 결정 프레임워크(애니메이션 필요성, 목적, 이징, 지속 시간)를 제공하여 UI 애니메이션을 체계적으로 설계하도록 돕습니다. 또한 60fps 골든 룰을 강조하며 `transform`과 `opacity` 속성만 GPU 합성하여 레이아웃 계산을 피하도록 안내합니다. CSS 트랜지션, 키프레임 애니메이션, 스프링 애니메이션, Web Animations API(WAAPI), 스크롤 기반 애니메이션, FLIP 기법, clip-path 애니메이션 등 다양한 구현 방법을 지원합니다. 특히 WAAPI는 메인 스레드에서 벗어나 실행되어 무거운 로드에서 Framer Motion보다 뛰어난 성능을 제공합니다. 이 기술은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 리뷰 형식으로 Before/After/Why 표를 요구하여 코드 품질을 일관되게 유지합니다. 접근성을 고려하여 `@media (prefers-reduced-motion: reduce)`를 통한 모션 감소 지원을 필수로 포함합니다.

지원 대상~Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/EliasOulkadi/shokunin/tree/HEAD/.pack/skills/motion-craft

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

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

문서

모션 크래프트은(는) 무엇을 하나요?

소통하는 애니메이션, 장식이 아닌. 모든 프레임은 그 자리를 차지해야 합니다.

Emil Kowalski(Linear, Sonner, Vaul), Paul Lewis(Google Chrome), CSS Animation Working Group에서 영감을 받았습니다.

워크플로

애니메이션 결정 프레임워크

애니메이션 코드를 작성하기 전에, 다음 네 가지 질문에 순서대로 답하세요.

1. 이 요소가 애니메이션되어야 합니까?

빈도결정이유
하루 100회 이상 (키보드 단축키, 명령 팔레트, 검색 토글)애니메이션 없음. 영원히.애니메이션은 빈번한 작업을 지연시킵니다. Raycast에는 열기/닫기 애니메이션이 없습니다. 최적입니다.
하루 수십 회 (호버 효과, 목록 탐색)제거하거나 크게 줄이기사용자가 반복 상호작용에서 애니메이션 지연을 인지합니다
가끔 (모달, 서랍, 토스트)표준 애니메이션모션에 적합한 장소입니다
드물게 / 처음 (온보딩, 확인, 축하)즐거움 추가이러한 순간은 더 길고 풍부한 애니메이션을 받을 자격이 있습니다

키보드로 시작되는 작업에는 절대 애니메이션을 적용하지 마세요. 이러한 작업은 하루에 수백 번 반복됩니다.

2. 목적은 무엇입니까?

모든 애니메이션은 "왜 이게 애니메이션되나요?"에 대한 명확한 답변이 있어야 합니다.

목적예유효?
공간적 일관성토스트가 같은 방향에서 들어오고 나감?
상태 표시버튼이 "전송됨"으로 변형됨?
피드백버튼이 눌릴 때 축소되어 인터페이스가 사용자를 들었음을 확인?
갑작스러운 변화 방지요소가 갑자기 나타나지 않고 페이드 인?
설명기능 작동 방식을 보여주는 마케팅 애니메이션?
"멋져 보여서" 그리고 사용자가 자주 봄불필요한 모션?

3. 어떤 이징을 사용해야 합니까?

시나리오이징CSS
요소 진입ease-out (빠르게 시작, 반응성 느낌)cubic-bezier(0, 0, 0.2, 1)
요소 이탈ease-in (천천히 시작, 잠시 주목을 끈 후 빠르게 사라짐)cubic-bezier(0.4, 0, 1, 1)
화면 내 이동 / 변형ease-in-outcubic-bezier(0.4, 0, 0.2, 1)
호버 / 색상 변경easecubic-bezier(0.25, 0.1, 0.25, 1)
일정한 움직임 (마키, 진행 표시줄)linearcubic-bezier(0, 0, 1, 1)
UI 상호작용 (버튼, 툴팁, 드롭다운)강한 ease-outcubic-bezier(0.23, 1, 0.32, 1)

중요: UI 진입 애니메이션에 ease-in을 절대 사용하지 마세요. 300ms의 ease-in 드롭다운은 동일한 300ms의 ease-out보다 느리게 느껴집니다. ease-in은 사용자가 가장 주의 깊게 보고 있는 바로 그 순간인 초기 움직임을 지연시키기 때문입니다.

4. 얼마나 빨라야 합니까?

요소지속 시간이징
버튼 누름 피드백 (크기 조절)100-160mscubic-bezier(0.23, 1, 0.32, 1)
툴팁 진입 / 이탈125-200mscubic-bezier(0.23, 1, 0.32, 1)
드롭다운 / 선택 / 팝오버150-250mscubic-bezier(0.23, 1, 0.32, 1)
호버 변형 (크기 조절, 들어올림)200mscubic-bezier(0.23, 1, 0.32, 1)
모달 / 다이얼로그 진입200-300mscubic-bezier(0, 0, 0.2, 1)
모달 / 다이얼로그 이탈150-200mscubic-bezier(0.4, 0, 1, 1)
서랍 / 시트 진입200-400mscubic-bezier(0.32, 0.72, 0, 1) (iOS 스타일)
토스트 진입300-400mscubic-bezier(0.23, 1, 0.32, 1)
토스트 이탈200-300mscubic-bezier(0.4, 0, 1, 1)
페이지 전환300-400mscubic-bezier(0.4, 0, 0.2, 1)
스크롤 공개 (페이드 + 슬라이드 업)400-800mscubic-bezier(0.16, 1, 0.3, 1)
로딩 시머1000-1500ms (무한)linear
길게 눌러 삭제 (누름)2000mslinear (의도적)
길게 눌러 삭제 (놓음)200mscubic-bezier(0.23, 1, 0.32, 1) (재빠름)
마케팅 / 설명800-3000ms가변, 내러티브에 따라 다름

규칙: UI 애니메이션은 300ms 미만을 유지하세요. 180ms 드롭다운은 400ms 드롭다운보다 훨씬 더 반응성이 뛰어나다고 느껴집니다.

사용자 정의 이징 곡선

내장 CSS ease / ease-in / ease-out은 너무 약합니다. 더 강력한 다음 사용자 정의 변형을 사용하세요:

:root {
  --ease-out-strong: cubic-bezier(0.23, 1, 0.32, 1);     /* UI 상호작용, Emil의 시그니처 */
  --ease-in-out-strong: cubic-bezier(0.77, 0, 0.175, 1);  /* 화면 내 이동 */
  --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);          /* iOS 스타일 서랍 */
  --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);         /* 느린 공개, 극적 */
  --ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1);       /* 대체 강력 ease-out */
  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);       /* 약간 오버슈트, 아껴서 사용 */
}

출처: easing.dev, easings.co


60fps 골든 룰

프레임당 16.67ms. Chrome DevTools Performance 탭으로 확인하세요. transform과 opacity만 애니메이션하세요.

속성GPU 합성?트리거
transform (translate, scale, rotate)? 예합성만
opacity? 예합성만
filter?? 가끔페인트 + 합성
clip-path?? 가끔페인트 + 합성
width, height, top, left, margin, padding, border-width? 아니요레이아웃 + 페인트 + 합성
box-shadow? 아니요페인트 + 합성
color, background-color? 아니요페인트만

리뷰 형식 (필수)

UI 애니메이션 코드를 검토할 때는 반드시 Before | After | Why 열이 있는 마크다운 표를 사용해야 합니다. "Before:"와 "After:"를 별도 줄에 나열하는 목록을 사용하지 마세요.

올바른 형식:

BeforeAfterWhy
transition: all 300mstransition: transform 200ms ease-out정확한 속성을 지정하세요. all을 피하면 레이아웃 재계산을 트리거합니다
transform: scale(0)transform: scale(0.95); opacity: 0실제 세계에서는 아무것도 없는 곳에서 나타나는 것이 없습니다
드롭다운에 ease-incubic-bezier(0.23, 1, 0.32, 1)ease-in은 천천히 시작합니다 - 느리게 느껴집니다. 강력한 ease-out은 즉각적인 피드백을 제공합니다
버튼에 :active 상태 없음:active에 transform: scale(0.97)버튼은 누름에 반응하는 느낌을 줘야 합니다
팝오버에 transform-origin: centertransform-origin: var(--radix-popover-content-transform-origin)팝오버는 트리거에서 크기가 조정되어야 합니다. 모달은 중앙에 유지됩니다.
prefers-reduced-motion 없는 transition: 300ms@media (prefers-reduced-motion: reduce) { transition-duration: 0.01ms }WCAG 2.1은 축소 모션 지원을 요구합니다
Framer Motion에서 animate={{ x: 100 }}animate={{ transform: "translateX(100px)" }}Framer Motion x/y는 하드웨어 가속되지 않습니다. GPU를 위해 transform 문자열을 사용하세요.

잘못된 형식 (절대 이렇게 하지 마세요):

Before: transition: all 300ms
After: transition: transform 200ms ease-out

CSS 트랜지션 (UI에 선호)

CSS 트랜지션은 중단 가능합니다 - 애니메이션 도중에 대상을 변경할 수 있습니다. 키프레임은 처음부터 다시 시작합니다. 빠르게 트리거될 수 있는 상호작용(토스트, 토글, 드롭다운)의 경우 트랜지션이 더 부드러운 결과를 생성합니다.

.button {
  transition: transform 160ms ease-out;
}
.button:active {
  transform: scale(0.97);
}

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}

비대칭 진입 / 이탈 타이밍

진입은 더 느릴 수 있고(사용자가 결정 중), 이탈은 빨라야 합니다(시스템 응답):

.overlay {
  transition: clip-path 200ms ease-out;  /* 놓음: 빠르게 */
}
.button:active .overlay {
  transition: clip-path 2s linear;       /* 누름: 느리고 의도적으로 */
}

툴팁: 후속 호버에서 지연 건너뛰기

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}
.tooltip[data-instant] {
  transition-duration: 0ms;
}

@starting-style을 사용한 진입 상태 (2026년 기준 Chrome 전용, 아직 Baseline 아님)

.toast {
  opacity: 1;
  transform: translateY(0);
  transition: opacity 400ms ease-out, transform 400ms ease-out;

  @starting-style {
    opacity: 0;
    transform: translateY(100%);
  }
}

참고: @starting-style 및 스크롤 기반 애니메이션(animation-timeline: view(), animation-timeline: scroll())은 2026년 기준 Chrome 전용입니다. 크로스 브라우저 지원을 위해 JavaScript 폴백을 사용하세요.

길게 눌러 삭제 패턴

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;   /* 놓음: 빠르게 */
}
.button:active .overlay {
  clip-path: inset(0 0 0 0);
  transition: clip-path 2s linear;        /* 누름: 느리고 의도적으로 */
}

버튼 - 촉각적 피드백

누를 수 있는 모든 요소에는 물리적 반응이 필요합니다.

.button {
  transition: transform 160ms cubic-bezier(0.23, 1, 0.32, 1);
}
.button:active {
  transform: scale(0.97);
}

크기 조절은 미묘해야 합니다(0.95-0.98). 버튼, 카드, 목록 항목, 탭 등 누를 수 있는 모든 요소에 적용됩니다.


팝오버 - 원점 인식

팝오버는 중앙이 아닌 트리거에서 크기가 조정됩니다. 모달은 중앙에 유지됩니다.

/* Radix UI */
.popover {
  transform-origin: var(--radix-popover-content-transform-origin);
}
/* Base UI */
.popover {
  transform-origin: var(--transform-origin);
}
/* 모달 (항상 중앙) */
.modal {
  transform-origin: center;
}

사용자가 개별적으로 알아채는지는 중요하지 않습니다. 전체적으로 볼 때 보이지 않는 세부 사항이 누적됩니다.


스태거 애니메이션

여러 요소가 함께 진입할 때, 그들의 등장을 지연시킵니다.

.item {
  opacity: 0;
  transform: translateY(8px);
  animation: fadeIn 300ms ease-out forwards;
}
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
.item:nth-child(4) { animation-delay: 150ms; }

@keyframes fadeIn {
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

스태거 지연을 짧게 유지하세요(항목 간 30-80ms). 스태거가 재생되는 동안 상호작용을 차단하지 마세요.


CSS 애니메이션 (키프레임)

미리 결정된, 동적이지 않은 애니메이션에 사용하세요. 키프레임은 중단 시 처음부터 다시 시작합니다 - UI에는 피하세요.

@keyframes enter-right {
  from { opacity: 0; transform: translateX(16px); }
  to   { opacity: 1; transform: translateX(0); }
}
.enter {
  animation: enter-right 300ms ease-out forwards;
}

스프링 애니메이션

스프링은 실제 물리학을 시뮬레이션하기 때문에 지속 시간 기반 애니메이션보다 더 자연스럽게 느껴집니다. 중단될 때 속도를 유지합니다.

스프링을 사용해야 할 때

  • 드래그 상호작용 (관성 포함)
  • "살아있는" 느낌이 드는 요소 (Apple Dynamic Island 스타일)
  • 애니메이션 도중 중단될 수 있는 제스처
  • 장식용 마우스 추적 상호작용

Apple 접근 방식 (권장 - 추론하기 쉬움)

{ type: "spring", duration: 0.5, bounce: 0.2 }

전통적인 물리학 (더 많은 제어)

{ type: "spring", stiffness: 100, damping: 10, mass: 1 }

바운스를 미묘하게 유지하세요(0.1-0.3). 대부분의 UI에서 바운스를 피하세요. 드래그하여 닫기 및 장난기 있는 상호작용에만 사용하세요.

스프링 기반 마우스 상호작용

import { useSpring } from 'framer-motion'

const springX = useSpring(mouseX * 0.1, { stiffness: 100, damping: 10 })

스프링 없음: 인위적이고 즉각적으로 느껴짐. 스프링 있음: 자연스럽고 관성이 있음.


WEB ANIMATIONS API (WAAPI)

프로그래매틱 CSS 애니메이션. 하드웨어 가속, 중단 가능, 라이브러리 불필요.

const element = document.querySelector('.card')

const animation = element.animate([
  { transform: 'scale(1)', opacity: 1 },
  { transform: 'scale(0.95)', opacity: 0.7 },
], {
  duration: 200,
  easing: 'cubic-bezier(0.23, 1, 0.32, 1)',
  fill: 'both',
})

animation.pause()
animation.play()
animation.reverse()
animation.finish()
animation.finished.then(() => console.log('done'))

WAAPI는 무거운 로드에서 Framer Motion을 능가합니다 - 메인 스레드 밖에서 실행됩니다. CSS 키프레임이 부족한 동적이고 중단 가능한 애니메이션에 사용하세요.


스크롤 기반 애니메이션

브라우저 지원 참고: 스크롤 기반 애니메이션(animation-timeline: view() 및 scroll())은 2026년 기준 Chrome/Edge 전용이며 아직 Baseline이 아닙니다. Firefox/Safari를 위해 IntersectionObserver를 통한 JS 폴백을 제공하세요.

ViewTimeline (요소가 뷰포트에 진입/이탈)

@keyframes fade-up {
  from { opacity: 0; transform: translateY(20px); }
  to   { opacity: 1; transform: translateY(0); }
}
.reveal {
  animation: fade-up 600ms linear both;
  animation-timeline: view();
  animation-range: entry 0% entry 100%;
}

ScrollTimeline (페이지 스크롤 위치)

@keyframes shrink {
  from { height: 80px; }
  to   { height: 50px; }
}
.site-header {
  animation: shrink 300ms linear both;
  animation-timeline: scroll();
  animation-range: 0 200px;
}

스크롤 연결 패럴랙스 (바닐라 JS)

const layers = document.querySelectorAll('[data-parallax]')
window.addEventListener('scroll', () => {
  const scrollY = window.scrollY
  layers.forEach(layer => {
    const speed = parseFloat(layer.dataset.parallax) || 0.3
    layer.style.transform = `translateY(${scrollY * speed}px)`
  })
})

FLIP 기법

레이아웃 애니메이션용 - 위치/크기가 변경되는 요소 애니메이션.

function animateLayout(element, callback) {
  const first = element.getBoundingClientRect()
  callback()
  const last = element.getBoundingClientRect()

  const dx = first.left - last.left
  const dy = first.top - last.top
  const dw = first.width / last.width
  const dh = first.height / last.height

  element.animate([
    { transform: `translate(${dx}px, ${dy}px) scale(${dw}, ${dh})` },
    { transform: 'translate(0, 0) scale(1, 1)' },
  ], {
    duration: 300,
    easing: 'cubic-bezier(0.4, 0, 0.2, 1)',
  })
}

애니메이션을 위한 CLIP-PATH

CSS에서 가장 강력한 애니메이션 도구 중 하나입니다. 하드웨어 가속.

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;
}
.visible {
  clip-path: inset(0 0 0 0);
}

다음에 사용: 길게 눌러 삭제, 스크롤 시 이미지 공개, 비교 슬라이더, 탭의 매끄러운 색상 전환.


인지된 성능

애니메이션의 속도는 사용자 경험에 직접적인 영향을 미칩니다.

Individual skills in this repo

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

관련 스킬