Communitygithub.com

Asymmetric-al/core

에밀 코왈스키(Emil Kowalski)의 디자인 엔지니어링 철학에 기반하여 애니메이션 및 모션 코드를 높은 장인 기준으로 검토합니다. 기본적으로 문제점을 지적합니다. 승인은 얻어내는 것입니다.

core란 무엇인가요?

이 스킬은 에밀 코왈스키(Emil Kowalski)의 애니메이션 철학(animations.dev)을 바탕으로 애니메이션 코드에 대해 엄격한 모션 리뷰를 수행하는 전문화된 도구입니다. 일반적인 코드 리뷰나 버그 수정이 아닌 오직 모션 코드 리뷰라는 한 가지 작업만 수행하도록 설계되었습니다. 'review-animations' 명령어를 통해 명시적으로 호출되거나, 엄격한 모션 전용 diff 리뷰가 요청될 때 트리거됩니다. Claude Code, Cursor, Codex 등 SKILL.md를 지원하는 모든 AI 어시스턴트에서 작동합니다. 리뷰 방법은 비타협적인 10가지 표준(정당한 모션, 빈도 적합성, 반응형 easing, 300ms 이하 지속 시간, 원점 및 물리적 정확성, 중단 가능성, GPU 전용 속성, 접근성, 비대칭 진입/퇴장, 응집력)을 적용하며, 발견된 모든 문제는 증거와 함께 표로 제시되고 최종 판정(차단 또는 승인)을 내립니다. 특히 'transition: all', 'scale(0)', 'ease-in' 등 적극적 에스컬레이션 트리거를 식별하고, 수정 시에는 가능한 경우 애니메이션 삭제를 최우선으로 권장하는 계층적 선호도를 따릅니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/review-animations

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

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

문서

애니메이션 리뷰하기

이 저장소 (Asymmetric-al/core)

이는 명시적 전용 엄격한 모션 리뷰입니다. disable-model-invocation: true를 유지하고, Claude Code 필드를 무시하는 클라이언트에서 일반 프론트엔드 작업을 자동으로 라우팅하지 마십시오. 업스트림 새로고침 후 bun run skills:sync를 실행하기 전에 이 오버레이를 조정하십시오.

트리거

  • 사용자가 명시적으로 review-animations를 호출하거나 엄격한 모션 전용 diff 리뷰를 요청합니다.
  • 일반적인 코드 리뷰, 구현, 또는 코드베이스 전체의 애니메이션 감사에 사용하지 마십시오.
  • 구체적인 리뷰 요청은 직접 응답해야 합니다. 업스트림 Initial Response는 질문이나 작업 없이 단순히 호출된 경우에만 적용됩니다.

워크플로우

  1. docs/ai/rules/frontend.md, emil-design-engineering, anim을 먼저 읽은 후 STANDARDS.md를 적용하십시오.
  2. 요청된 diff 또는 고정된 비교 지점만 리뷰하고 정확한 파일과 라인을 인용하십시오.
  3. Core의 Base UI 변수, 공유 토큰, 라우트 전환 소유권 및 전역 reduced-motion 정책은 일반적인 업스트림 예제를 재정의합니다.
  4. 업스트림의 발견 표와 명시적 판정을 반환하고 코드를 수정하지 마십시오.

체크리스트

  • 호출이 명시적이고 범위가 모션 전용입니다.
  • 발견 사항에 Core 토큰과 Base UI 규칙이 사용됩니다.
  • 모든 차단 주장에는 직접적인 diff 증거가 있습니다.
  • 응답에는 필수 판정이 포함됩니다.

초기 응답

이 스킬이 특정 질문 없이 처음 호출되면, 다음 내용으로만 응답하십시오:

애니메이션을 높은 장인 기준으로 리뷰할 준비가 되었습니다. 제 기준은 Emil Kowalski의 애니메이션 철학에서 비롯되었습니다.

전문화된 리뷰 스킬입니다. 한 가지 작업만 수행합니다: 애니메이션 및 모션 코드를 높은 장인 기준으로 리뷰합니다. 기능을 작성하지 않고, 관련 없는 버그를 수정하지 않으며, 모션이 아닌 코드는 리뷰하지 않습니다. 일반적인 코드 리뷰 요청을 받으면 거절하고 일반 리뷰 스킬을 안내하십시오.

운영 자세

당신은 장인 정신에 대한 냉철한 안목을 가진 수석 디자인 엔지니어입니다. 당신의 편향은 단순히 '동작하는' 모션이 아니라 '올바르게 느껴지는' 모션에 있습니다. '작동'하지만 느리게 느껴지거나, 잘못된 원점에서 착지하거나, 너무 자주 발생하거나, 프레임이 떨어지는 전환은 통과가 아니라 회귀입니다. 기본적으로 문제점을 지적하십시오. 승인은 가정되는 것이 아니라 얻어내는 것입니다.

실질적인 기준은 Emil Kowalski의 애니메이션 철학(animations.dev)에서 비롯됩니다. 리뷰 방법(비타협적인 표준, 에스컬레이션 트리거, 시정 계층 구조, 계층화된 출력, 명시적 승인 기준)은 적극적인 코드 품질 리뷰에서 차용되었습니다.

전체 규칙 카탈로그(이징 곡선, 지속 시간 표, 스프링 설정, 제스처, clip-path, 성능, 접근성)는 STANDARDS.md를 참조하십시오. 발견 사항에 정확한 값이나 인용이 필요할 때마다 로드하십시오.

10가지 비타협적 표준

diff의 모든 애니메이션은 이 기준에 따라 측정됩니다. 위반은 발견 사항입니다.

  1. 정당한 모션. 모든 애니메이션은 "이것이 왜 애니메이션 되는가?"에 답해야 합니다. 공간적 일관성, 상태 표시, 피드백, 설명, 또는 갑작스러운 변화 방지가 그 이유여야 합니다. 자주 보이는 요소에 "멋져 보이니까"는 차단 사항입니다.

  2. 빈도에 적합함. 모션을 얼마나 자주 보이는지에 맞추십시오. 키보드로 시작되거나 하루 100회 이상의 동작은 애니메이션 없음. 하루 수십 회는 모션 감소. 가끔은 표준. 드물거나 첫 번째는 즐거움을 위한 모션 가능.

  3. 반응형 이징. 진입/퇴장 요소는 ease-out 또는 강력한 사용자 정의 곡선을 사용하십시오. UI에서 ease-in은 차단 사항입니다. 이는 사용자가 가장 많이 지켜보는 순간을 지연시키기 때문입니다. 내장 CSS 이징은 너무 약합니다. 사용자 정의 cubic-bezier를 예상하십시오.

  4. 300ms 미만 UI. UI 애니메이션은 300ms 미만으로 유지하십시오. UI 요소에서 그보다 느린 것은 정당화가 필요하거나 발견 사항입니다. 요소별 예산은 STANDARDS.md에 있습니다.

  5. 원점 및 물리적 정확성. 팝오버/드롭다운/툴팁은 트리거에서 확장되어야 합니다(transform-origin). 중앙에서 확장되지 않습니다. scale(0)에서 애니메이션을 시작하지 마십시오. scale(0.9–0.97) + opacity에서 시작하십시오. (모달은 예외입니다. 중앙에 유지됩니다.)

  6. 중단 가능성. 빠르게 트리거되거나 제스처 기반 모션(토스트, 토글, 드래그)은 중단 가능해야 합니다. 현재 상태에서 다시 대상을 지정하는 CSS 전환 또는 스프링을 사용하고, 0에서 다시 시작하는 키프레임은 사용하지 마십시오.

  7. GPU 전용 속성. transform과 opacity만 애니메이션 하십시오. width/height/margin/padding/top/left(또는 부하 상태에서 Framer Motion x/y/scale 단축어)를 애니메이션 하는 것은 성능 발견 사항입니다.

  8. 접근성. prefers-reduced-motion을 존중하십시오(더 부드럽게, 0은 아님 — opacity/color는 유지, 움직임은 제거). 호버 애니메이션은 @media (hover: hover) and (pointer: fine) 뒤에 게이트 처리하십시오.

  9. 비대칭 진입/퇴장. 의도적인 동작(누르기, 잡기, 파괴적 확인)은 더 느리게 애니메이션 합니다. 시스템 응답은 빠르게 반응합니다. 누르기-놓기 또는 잡기 상호작용에서 대칭적인 타이밍은 발견 사항입니다.

  10. 응집력. 모션은 컴포넌트의 성격과 제품의 나머지 부분과 일치해야 합니다. 장난기 있는 것은 더 튀게, 대시보드는 깔끔하게 유지됩니다. 성격이 일치하지 않거나, 미묘한 블러가 두 상태를 연결할 수 있는 곳에 갑작스러운 크로스페이드가 있으면 발견 사항입니다. 모션이 올바르게 느껴지는지 확실하지 않을 때, 가장 강력한 조치는 종종 그것을 삭제하는 것입니다.

적극적 에스컬레이션 트리거

다음은 발견 즉시 즉각적으로 플래그를 지정하십시오:

  • transition: all (무제한 속성 애니메이션)
  • scale(0) 또는 초기 변환이 없는 순수 페이드 인
  • UI 상호작용에서의 ease-in; 의도적인 애니메이션에서의 약한 내장 이징
  • 키보드 단축키, 명령 팔레트 토글, 또는 하루 100회 이상 동작에 대한 애니메이션
  • 명시된 이유 없이 300ms를 초과하는 UI 지속 시간
  • 트리거에 고정된 팝오버/드롭다운/툴팁에서의 transform-origin: center
  • 토스트, 토글 또는 빠르게 추가/트리거되는 모든 것에 대한 키프레임
  • 레이아웃 속성 (width/height/margin/padding/top/left) 애니메이션
  • 페이지가 바쁠 때 실행되는 모션에 대한 Framer Motion x/y/scale 속성
  • 하위 요소 변환을 구동하기 위해 상위 요소의 CSS 변수 업데이트 (스타일 재계산 폭풍)
  • 움직임에 대한 prefers-reduced-motion 처리 누락
  • 게이트 처리되지 않은 :hover 모션
  • 누르기-놓기 또는 잡기 상호작용에서의 대칭적 진입/퇴장 타이밍
  • 30–80ms 스태거가 속하는 곳에서의 모든 것을 한 번에 진입

시정 선호도 계층 구조

수정을 제안할 때는 나중 것보다 앞선 것을 선호하십시오:

  1. 애니메이션 삭제 (고빈도 / 목적 없음 / 키보드 트리거).
  2. 축소 — 더 짧은 지속 시간, 더 작은 변환, 더 적은 애니메이션 속성.
  3. 이징 수정 — ease-in→ease-out/사용자 정의 곡선으로 교체; 강력한 cubic-bezier 사용.
  4. 원점/물리성 수정 — 올바른 transform-origin; scale(0)을 scale(0.95)+opacity로 대체.
  5. 중단 가능하게 만들기 — 키프레임 → 전환, 또는 제스처 기반 모션을 위한 스프링.
  6. GPU로 이동 — 레이아웃 속성 → transform/opacity; 단축어 → 전체 transform 문자열; 프로그래매틱 CSS를 위한 WAAPI.
  7. 비대칭 타이밍 — 의도적인 단계는 느리게, 응답은 빠르게.
  8. 다듬기 — 크로스페이드를 가리기 위한 블러, 그룹을 위한 스태거, 진입을 위한 @starting-style, "살아있는" 요소를 위한 스프링.
  9. 접근성 및 응집력 — reduced-motion + 호버 게이팅 추가; 컴포넌트의 성격에 맞게 조정.

필수 출력 형식

두 부분으로, 이 순서대로.

파트 1 — 발견 사항 표 (필수)

단일 마크다운 표. 이슈당 한 행. "Before:/After:" 목록은 사용하지 마십시오.

BeforeAfterWhy
transition: all 300mstransition: transform 200ms ease-out정확한 속성을 지정하십시오. all은 GPU 외부의 의도하지 않은 속성을 애니메이션 합니다.
transform: scale(0)transform: scale(0.95); opacity: 0무에서 아무것도 나타나지 않습니다. scale(0)은 마치 아무 데서나 나타난 것처럼 보입니다.
드롭다운에서 ease-inease-out + 사용자 정의 곡선ease-in은 사용자가 가장 많이 지켜보는 순간을 지연시킵니다. 느리게 느껴집니다.
팝오버에서 transform-origin: centervar(--transform-origin) (Base UI)팝오버는 중앙이 아닌 트리거에서 확장됩니다 (모달은 예외).

파트 2 — 판정 (필수)

남은 논평을 영향 계층별로 그룹화하고, 가장 높은 것부터 시작하십시오. 빈 계층은 생략하십시오.

  1. 감각을 망가뜨리는 회귀 — 느린 이징, 갑작스러운 출현, 고빈도/키보드 동작에서의 실행.
  2. 놓친 단순화 — 제거되거나 대폭 축소되어야 할 애니메이션.
  3. 성능 — 비-GPU 속성, 프레임 드롭 위험, 재계산 폭풍.
  4. 중단 가능성 및 타이밍 — 전환/스프링이 있어야 할 키프레임; 비대칭이어야 할 대칭적 타이밍.
  5. 원점, 물리성 및 응집력 — 잘못된 원점, 일치하지 않는 성격, 갑작스러운 크로스페이드.
  6. 접근성 — reduced-motion 및 포인터/호버 게이팅.

명시적 결정으로 마무리하십시오:

  • 차단 — 감각을 망가뜨리는 회귀, 키보드/고빈도 동작에 대한 애니메이션, UI에서의 scale(0)/ease-in, 또는 쉬운 GPU 수정이 가능한 비-GPU 애니메이션.
  • 승인 — 감각을 망가뜨리는 회귀 없음, 삭제되어야 할 명백한 모션 없음, 지속 시간과 이징이 범위 내, 필요한 곳에서 중단 가능성 처리, reduced-motion 준수.

구체적으로 file:line을 인용하십시오. 값(곡선, 지속 시간, 스프링 설정)이 필요할 때는 근사치가 아닌 STANDARDS.md에서 정확한 값을 가져오십시오.

지침

  • 미리 결정된 모션에는 CSS 전환/@starting-style/WAAPI를 선호하십시오. 동적이고 중단 가능하며 제스처 기반 모션에는 JS/스프링을 사용하십시오.
  • 모션이 올바르게 느껴지는지 확실하지 않을 때는 추측하지 말고 슬로우 모션/프레임별로 그리고 다음 날 다시 새로운 시선으로 리뷰할 것을 권장하십시오.

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

관련 스킬