Communitygithub.com

antheo-motion

UI 요소가 움직여야 할지 결정하고, 정확한 타이밍, 이징(easing), 거리를 부여합니다(누름, 호버, 메뉴, 다이얼로그, 시트, 드래그, 페이지 전환). 축소 모션(reduced motion)도 처리합니다. UI가 뚝뚝 끊기거나, 정적이거나, 과하게 움직일 때, 드로어나 드래그가 어색할 때, 또는 애니메이션을 배포하기 전에 사용하세요.

antheo-motion란 무엇인가요?

이 스킬은 UI 애니메이션을 체계적으로 설계하고 감사(audit)하는 방법을 제공합니다. 'antheo-motion'은 모든 화면 변화(열림/닫힘, 등장/사라짐, 재정렬 등)를 목록화하고, 사용자가 보는 빈도에 따라 지속 시간과 이징을 할당합니다. 자주 보는 동작(예: 타이핑, 탭)에는 최대 150ms, 드물게 보는 동작(예: 주문 완료)에는 시그니처 모멘트(signature moment)를 위한 더 긴 시간을 부여합니다. CSS 전환(transitions)과 키프레임(keyframes)을 적절히 사용하고, 트리거(trigger)에서 시작하며, `transform`과 `opacity` 같은 허용된 속성만 사용하도록 규칙을 정합니다. 또한, `prefers-reduced-motion`을 준수하여 축소 모션에서는 모든 이동을 150~200ms 페이드 전환(fade crossfade)으로 대체합니다. 이 스킬은 프레임별로 모션을 촬영하고 검토하는 `filmstrip.mjs` 스크립트를 포함하며, 레시피, 이유, 성능, 고급 주제 등 다양한 참고 자료(references)를 제공합니다. Claude Code, Cursor, Codex 등 모든 AI 에이전트와 호환되며, 마크다운(markdown) 기반의 문서로 제공됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antheo-design/skills/tree/HEAD/skills/antheo-motion

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

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

문서

Antheo Motion

모션은 변화에 대한 정보입니다. 어떤 것이 도착했거나, 떠났거나, 이동했거나, 응답했다는 것을 의미합니다. 아무것도 설명하지 않는 모션은 소음(Sound)일 뿐이며, 모션이 없는 변화는 점프(Jump)처럼 보입니다. 이 스킬은 어떤 변화가 움직여야 하는지 결정하고 각각에 정확한 타이밍을 부여합니다. 컴포넌트의 단 하나의 시그니처 모멘트(signature moment)는 antheo-moment에 속하며, 지속 시간 토큰은 antheo-tokens가 생성하고, 축소 모션(reduced-motion) 요구 사항은 antheo-access가 확인합니다. 전체 앱의 모션을 감사(audit), 축소, 계획하는 것은 antheo-motion-audit의 역할입니다.

다음 순서대로 결정하세요

  1. 화면의 모든 변화를 나열하세요: 무엇이 열리고, 닫히고, 나타나고, 사라지고, 재정렬되고, 업데이트되고, 로드되고, 성공하거나 실패하는지.
  2. 사용자가 보는 빈도를 표시하세요: 하루에 여러 번, 매일, 또는 드물게.
  3. 아래 표에서 각각에 지속 시간과 이징(easing)을 할당하세요.
  4. 하나뿐인 드문 의미 있는 이벤트가 있다면, 그것을 antheo-moment에 넘기세요.
  5. 빠르게, 두 번, 그리고 축소 모션으로 확인한 다음, 촬영하고 프레임을 읽으세요 (아래 참조).

왜 움직이는지 이름을 붙이세요. 그렇지 않으면 움직이지 마세요

"이것은 사용자가 ___을 이해할 수 있도록 움직입니다." 문장을 완성할 수 없다면: 애니메이션 없음.

더 자주 보일수록, 덜 움직입니다

얼마나 자주무엇을 얻나
하루에 여러 번 (타이핑, 행, 탭, 메뉴, 팔레트)최대 150ms, 4px 이동; 키보드에서는 짧은 페이드만
매일 (다이얼로그, 시트, 토스트, 저장)짧은 도착과 더 빠른 종료, 150~300ms
드물게 (첫 성공, 주문 완료)시그니처 모멘트를 위한 한 곳 (antheo-moment)

작업별 지속 시간

토큰값용도
--dur-instant100ms색상 및 불투명도 피드백
--dur-fast150ms누름, 호버 인/아웃, 메뉴 또는 툴팁 열림
--dur-base200ms사라지는 것, 다이얼로그 닫힘, 값 또는 텍스트 교체, 토스트 도착
--dur-open250ms다이얼로그 열림, 탭, 아코디언, 카드 크기 조절
--dur-slow300ms시트 또는 드로어 올라옴, 마커 가로지름
--dur-page400ms페이지 또는 공유 요소 전환

인터페이스 모션은 300ms 이하, 페이지 이동은 400ms 이하로 유지합니다. 스피너, 진행률 및 스크롤 연결 모션은 linear로 실행됩니다.

열기와 닫기, 쌍으로

요소열기닫기
메뉴, 팝오버, 선택150ms, scale(0.97) 및 페이드, 트리거에서 시작120ms
툴팁400ms 지연 후 150ms 페이드; 다른 툴팁 닫힘 후 300ms 이내에는 즉시즉시
다이얼로그250ms: 8px 상승, 페이드, scale 0.96에서200ms
시트, 드로어가장자리에서 300ms, 전체 불투명도 유지 (페이드나 블러 없음)200ms
토스트200ms, 12px 상승200ms, 왔던 방향으로
아코디언, 높이 드러내기250ms, grid-template-rows: 0fr에서 1fr로200ms

닫기나 호버 아웃(hover-out)을 절대 지연시키지 마세요. 대신 지속 시간을 줄이세요.

도착과 이탈을 위한 하나의 곡선

--ease-out cubic-bezier(0.23, 1, 0.32, 1)은 들어오거나 나가는 모든 것에 사용합니다. --ease-in-out cubic-bezier(0.77, 0, 0.175, 1)은 화면의 한 곳에서 다른 곳으로 이동하는 것에만 사용합니다. --ease-in은 영원히 버려지는 것에만 사용합니다. 종료는 시작보다 빠르며 약 절반 정도만 이동합니다.

작은 거리, 0에서 시작하지 않음

값 교체나 팝오버는 4px, 다이얼로그는 8px, 토스트는 12px, 히어로 부분은 24px 이동; 시트만 전체 가장자리에서 이동합니다. scale(0)이 아니라 scale(0.96) (메뉴는 0.97, 툴팁은 0.98)과 불투명도 0에서 시작합니다. 텍스트 또는 아이콘 교체 시 4px 블러, 큰 표면은 8px, 200ms 미만의 크로스페이드에서는 2px 블러를 사용합니다.

애니메이션 가능한 것

기본적으로 transform과 opacity (그리고 색상); 필요한 경우 짧은 filter 블러, clip-path, 높이 드러내기를 위한 grid-template-rows. 절대 transition: all을 사용하지 말고, width, height, top, left, margin을 사용하지 마세요. box-shadow 자체는 사용하지 말고, 변화하는 그림자는 의사 요소(pseudo-element)에 넣고 페이드 처리하세요. will-change는 프로파일링 후에만 사용하세요.

트리거에서 성장하세요

메뉴와 팝오버는 transform-origin을 트리거에 둡니다 (Radix는 --radix-popover-content-transform-origin을 노출합니다); 모달은 중앙에 유지됩니다; 시트는 자신이 있는 가장자리에서 옵니다; 공유 요소(카드가 페이지로 열리는 경우)는 각 면에 하나의 view-transition-name을 사용합니다.

상태 전환(transition)은 CSS 전환으로, 일회성(one-shot)은 키프레임으로

사용자가 토글할 수 있는 모든 것은 CSS 전환이나 스프링(spring)을 사용하며, 이는 중간에 역전(reverse)될 수 있습니다; 키프레임은 한 번만 재생되는 것에만 사용합니다.

30~40ms 간격으로 스태거(stagger), 처음 8개, 총 300ms 이내

히어로의 36개 부분은 6080ms 간격. 자주 여는 것은 스태거하지 말고, 항목이 도착하는 동안 클릭을 차단하지 마세요.

스프링(spring)은 손이 움직이는 곳에만 사용

스위치 노브, 놓은 드래그, 미끄러지는 분할 알약. 컨트롤에서 바운스 0~0.2 (오버슈트는 트랙 내에 유지), 드문 축하에서는 최대 0.45; 최대 한 번의 흔들림. 드래그는 손가락을 전환 없이 따르며, 놓을 때 놓는 속도에서 스프링으로 움직입니다. 시트는 약 0.11px/ms보다 빠른 플릭(flick)으로 닫히거나, 높이의 min(64px, 15%) 이상 이동하면 닫히고, 그렇지 않으면 다시 스프링백(spring back)됩니다 (references/gestures.md 참조).

점프 없음

변경되는 모든 값은 변경되는 것으로 보입니다. 제거된 행은 간격을 닫습니다; 나타나는 것을 위해 공간이 예약됩니다 (레이아웃 시프트 0.1 미만). 로드 시 최대 하나의 입장. 테마 전환 시 한 프레임 동안 전환을 끄고 수행합니다.

축소 모션은 이야기를 페이드로 유지합니다

prefers-reduced-motion: reduce에서 이동, 크기 조절, 블러, 시차(parallax) 및 바운스는 150~200ms 불투명도 크로스페이드가 됩니다; 스위치 노브는 즉시 이동합니다; 자동 재생 루프는 멈춥니다. 5초 이상 자체적으로 움직이는 모든 것은 일시 중지 컨트롤이 있습니다 (WCAG 2.2.2); 1초에 3회 이상 깜빡이지 않습니다 (2.3.1).

전체 앱에 걸쳐

  1. 찾기: 모든 변화, 얼마나 자주 보이는지, 현재 어떻게 움직이는지, 어떻게 움직여야 하는지에 대한 표.
  2. 개선하기: 모든 숫자에 대한 토큰, 누락된 종료, 트리거에서의 원점, 한 번에 하나의 패턴.
  3. 제거하기: 매 로드마다 애니메이션되는 것, 하루에 여러 번 동작에서 재생되는 것, 다음 동작을 지연시키는 것, 사용자가 읽는 동안 반복되는 것, 또는 일상적인 동작에서 300ms를 초과하는 것. 확실하지 않으면 제거.
  4. 승인 또는 차단: 이유 문장, 토큰만, 허용된 속성만, 입장보다 빠른 종료, 축소 모션 처리, 일반 속도 및 4배 CPU 저하에서 확인.

확인하기

모든 것을 빠르게 두 번 클릭하세요: 역전되고, 절대 점프하지 않습니다. 메뉴를 스무 번 열어보세요: 여전히 빠릅니다. CPU를 4배 저하시키세요: 여전히 부드럽습니다. 축소 모션을 켜세요: 아무것도 이동하지 않습니다.

보기: 정지 이미지로는 모션을 판단할 수 없습니다

정지 상태의 스크린샷은 어떻게 움직이는지에 대해 아무것도 알려주지 않으며, 모든 검사자는 정지 프레임을 읽습니다. 따라서 만든 각 모션을 촬영하고 완료되었다고 판단하기 전에 프레임을 살펴보세요:

node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900

페이지를 0.1배속(CSS, Web Animations 및 JavaScript 클록)으로 늦추고, 한 가지 동작을 수행한 후 요소의 12개 프레임을 하나의 시트에 배치하며, 각각 시간이 표시됩니다. 시트를 열고 모든 프레임을 읽으세요:

  • 각 프레임은 그 자체로 구성되어 보입니다: 단단한 가장자리가 미끄러져 들어오거나, 잘못된 색상이 번쩍이거나, 빈 상자가 없습니다.
  • 변경되는 모든 값이 변경되는 것으로 보입니다: 굴러야 할 숫자가 바늘이 여전히 이동하는 동안 갑자기 변하지 않습니다.
  • 중간에 리플로우(reflow)되거나 점프하지 않습니다; 첫 번째 프레임이 이미 누름에 응답합니다.
  • 끝은 제자리에 안정됩니다: 스프링이 약간 오버슈트하고 돌아오며, 컨트롤이 갑자기 멈추지 않습니다.
  • --reduce 및 --dark로 다시 촬영하세요: 이야기는 여전히 전달되며, 어두운 모드에서 빛의 섬광이 없습니다.

프레임이 보여주는 것을 수정하고, 다시 촬영한 후 마지막 시트를 증거로 보관하세요.

생성된 UI가 여기서 잘못하는 것

완료되기 전에 각각을 references/habits.md에서 확인하세요: transition: all · 스크립트가 드러낼 때까지 숨겨진 콘텐츠 · 포괄적인 축소 모션 리셋 · 페이드 인 또는 슬라이드 인되는 포커스 링 · 성능을 발휘하는 모션 · 클릭 가능하지 않은 것에 대한 호버 효과 · 아무도 정의하지 않은 이름을 읽는 전환.

더 많은 모션이 적합한 경우

목적과 빈도 규칙이 결정하며, 숫자는 기본값입니다. 게임, 창작 도구, 학습 제품 또는 사용자가 요청한 브랜드 순간은 더 많이, 더 오래 움직일 수 있습니다. 그래도 입력에 즉시 응답하고, 다음 동작을 차단하지 않으며, 중간에 중단될 수 있고, 축소 모션을 존중하며, 비용을 보여줍니다: 중간 범위 전화기에서 느린 프레임은 스타일과 관계없이 발견 사항입니다.

완료

  • 모든 변화가 얼마나 자주 보이는지와 함께 나열됨; 자주 보이는 것은 거의 움직이지 않음; 키보드 동작은 이동하지 않음
  • 지속 시간과 이징이 토큰에서 가져옴; 위의 열기/닫기 쌍; 지연된 닫기 없음
  • 허용된 속성만 사용; 트리거에서 원점; scale(0)에서 시작하지 않음
  • 축소 모션은 크로스페이드가 됨; 5초 이상의 루프는 일시 중지 가능
  • 4배 저하 및 축소 모션에서 빠르게 두 번 클릭하여 확인
  • 각 모션 촬영 (scripts/filmstrip.mjs), 모든 프레임 읽음, 밝은 모드, 어두운 모드 및 축소 모드
  • references/habits.md의 모든 습관에 대해 확인

파일

  • scripts/filmstrip.mjs: 하나의 모션을 0.1배속으로 촬영하여 프레임 시트로 만들고, 각 프레임 아래에 시간 표시
  • references/recipes.md: 누름과 팝오버부터 숫자 롤과 스트리밍 텍스트까지, 각각 references/recipes/에 있는 36개의 복사 준비된 레시피 색인
  • references/why.md: 값이 임의적으로 보이거나 누군가가 깨고 싶을 때를 위한 모든 규칙의 이유
  • references/gestures.md: 드래그, 스와이프, 시트, 스냅 포인트, 모멘텀, 러버 밴딩 (전화기 느낌: antheo-mobile)
  • references/choreography.md: 여러 가지를 하나의 변화로: 간격 닫기, 재정렬, 패널 크기 조절, 크로스페이드
  • references/springs.md: 평범한 언어로 된 스프링, 프리셋, 30줄 JS 스프링, 폴백이 있는 linear()
  • references/performance.md: 애니메이션하기 저렴한 것, 저렴한 전화기에서 60fps, 프로파일링 방법
  • references/advanced.md: 3D, 스크롤 기반 애니메이션, View Transitions, 모션 촬영
  • references/vocabulary.md: 평범한 설명에서 패턴 이름, 레시피로
  • references/motion-kit.css: 생성된 motion.css의 폴백 복사본
  • references/habits.md: 생성된 UI가 여기서 잘못하는 것, 각각 수정 방법 포함

관련 스킬