LottieFiles motion-design-skill: AI 에이전트를 위한 12가지 모션 디자인 원칙 스킬
Claude Code, Cursor 등 40여 개 코딩 에이전트에 UI 타이밍, 이징, 디즈니 12원칙 기반 모션 디렉팅 가이드를 주입하는 오픈소스 스킬 팩을 살펴봅니다.
로티파일즈(LottieFiles)가 오픈소스로 공개한 motion-design-skill은 코딩 보조 AI 에이전트가 화면 모션을 짤 때 디자이너처럼 사고하도록 돕는 프롬프트·가이드라인 지침 팩입니다. Claude Code, Cursor, Codex, GitHub Copilot 등 40개 이상의 에이전트 환경에서 단 한 줄의 명령어로 연동할 수 있습니다.

이미지 출처: LottieFiles 쨌 CC BY-SA 4.0 쨌 https://creativecommons.org/licenses/by-sa/4.0 쨌 https://commons.wikimedia.org/wiki/File:ThorVG_Icon_Primary.png
기존 코딩 어시스턴트에 UI 애니메이션 작성을 요청하면 단순한 transition: all 0.3s ease 수준의 밋밋한 코드를 내놓거나, 화면 내 여러 요소가 제각각 움직여 시각적 산만함을 유발하는 경우가 흔했습니다. 이번 저장소는 애니메이션 코드를 작성하기 전에 타이밍, 이징(속도 변화 곡선), 안무(Choreography), 감정 표현 의도를 먼저 계산하도록 에이전트의 판단 규칙을 체계화했습니다.
에이전트 스킬이란 무엇이며 왜 필요한가
AI 코딩 환경에서 '스킬(Skill)'은 특정 도메인 지식과 작업 규칙을 묶어 에이전트에 주입하는 모듈형 지침서입니다. 사용자가 매번 긴 시스템 프롬프트를 복사해 넣지 않아도, 관련 작업이 감지되면 에이전트가 해당 규칙을 참조해 일관된 수준의 결과물을 작성합니다.
motion-design-skill은 UI 모션 기획 단계에서 에이전트가 점검해야 할 기준을 4단계 계층 구조로 정리했습니다.
- Core (
SKILL.md): 500줄 이하의 핵심 지침 파일로, 8단계 체크리스트와 지속 시간·이징 표, 속성 선택 가이드, 품질 검증 규칙을 담고 있습니다. - Philosophy (
director/): 1981년 디즈니 애니메이터들이 정립한 '애니메이션 12원칙'을 현대 웹·앱 인터페이스에 맞게 재해석한 가이드입니다. 예비 동작(Anticipation), 감속/가속(Slow In and Slow Out), 시차 연출(Staging) 등을 UI 상황에 적용하는 논리를 설명합니다. - Patterns (
patterns/): 진입·퇴장(Entrance/Exit), 피드백 상태(성공, 에러, 로딩, 호버), 연속 배경 움직임, 다중 요소 시차 연출을 위한 실무 레시피를 제공합니다. - Reference (
reference/): 밀리초(ms) 단위의 권장 타이밍 표, 이징 곡선 선택 기준, 성능 저하를 방지하기 위한 속성 점검표(Troubleshooting)를 모았습니다.
이 지침이 에이전트 프롬프트에 들어가면, 사용자가 "카드 컴포넌트 목록에 진입 애니메이션을 넣어줘"라고 요청했을 때 에이전트는 모든 카드를 일괄 노출하지 않고 시차(Stagger) 간격을 계산하며 적절한 감속 곡선을 적용해 코드를 짭니다.
라이브러리에 종속되지 않는 설계와 설치 방식
이 도구의 주된 특징은 특정 프레임워크나 렌더러에 묶이지 않는 '구현 무관(Implementation-Agnostic)' 방식을 취한다는 점입니다. 순수 CSS 키프레임과 트랜지션은 물론, React 생태계의 Framer Motion, 전문 인터랙션 라이브러리인 GSAP, 벡터 애니메이션 런타임인 Lottie, 스프링 물리 엔진까지 어떤 기술 스택을 사용하는 프로젝트에서도 모션 디렉팅 규칙을 동일하게 적용할 수 있습니다.
설치는 터미널에서 skills 패키지 관리자를 통해 즉시 진행할 수 있습니다.
npx skills add LottieFiles/motion-design-skill
명령을 실행하면 로컬 에이전트 설정 디렉터리에 가이드라인 파일이 등록됩니다. 이후 에이전트에 다음과 같은 자연어 명령을 내리면 스킬이 자동으로 활성화됩니다.
Add a playful entrance animation to these card components
Create a loading -> success -> error state transition for this form submit button
Choreograph the entrance sequence for this dashboard: hero chart first, then stats cards, then sidebar
Review my animation code and suggest improvements based on motion design principles
에이전트는 단순히 동작하는 코드를 생성하는 것에 그치지 않고, "이 버튼은 클릭 피드백이 즉각적이어야 하므로 100ms 미만의 반응형 스케일 다운을 적용했습니다"와 같이 디자인 의도를 설명서 형태로 함께 제시합니다.
실무 도입 시 고려사항과 한계
motion-design-skill은 자체적으로 화면을 렌더링하는 런타임 자바스크립트 라이브러리가 아닙니다. 에이전트의 '판단력'을 보정하는 텍스트 지침 파일들의 모음이므로, 실제로 코드가 작동하려면 프로젝트 내부 대상 라이브러리(CSS, Tailwind CSS, Framer Motion, GSAP 등)가 설치되어 있어야 합니다.
또한 복잡한 3D 씬이나 대규모 Canvas 파티클 연출처럼 하드웨어 가속 최적화가 필수적인 영역에서는 에이전트가 제안한 타이밍 수치가 실제 브라우저 렌더링 프레임(FPS) 드롭을 일으킬 가능성이 있습니다. 따라서 에이전트가 제안한 모션 속성이 transform이나 opacity 같은 GPU 가속 가능 속성에 집중되어 있는지, 그리고 사용자의 '동작 줄이기(prefers-reduced-motion)' 접근성 미디어 쿼리를 누락하지 않았는지를 개발자가 직접 검토해야 합니다.
현재 이 저장소는 LottieFiles 공식 계정 하에 MIT 라이선스로 배포되고 있으며, 3,000개 이상의 GitHub 스타를 기록하며 에이전트 스킬 생태계에서 실무적 참조 사례로 자리 잡고 있습니다.
출처
- GitHub 저장소: LottieFiles/motion-design-skill