Communitygithub.com

animate-ui (애니메이트 UI)

트리거: animate-ui, motion 컴포넌트, 애니메이션 shadcn. Animate UI의 Motion 기반 컴포넌트를 구현하고 커스터마이징합니다.

animate-ui (애니메이트 UI)란 무엇인가요?

이 스킬은 Animate UI 배포판을 사용하여 애니메이션 UI 컴포넌트를 추가하거나 커스터마이징하는 방법을 제공합니다. shadcn/ui 프로젝트에서 Framer Motion(Motion) 기반 패턴을 구현할 때 유용하며, Animate UI 레지스트리 설정 및 특정 프리미티브/컴포넌트 추가를 지원합니다. 이 스킬은 `motion`, `tailwind-merge`, `clsx`, `lucide-react`와 같은 종속성을 확인하고, `@animate-ui/{category}-{sub-category}-{name}` 명명 규칙을 따르도록 안내합니다. 또한 shadn CLI를 통해 프리미티브와 컴포넌트를 설치하고 `@/components/animate-ui/` 경로에서 가져와 사용하는 절차를 포함합니다. 개발자는 이 스킬을 통해 복사-우선 접근 방식으로 컴포넌트를 수정하고, 스프링 전환(stiffness, damping)을 프로젝트 감성에 맞게 조정할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deuriib/agent-skills/tree/HEAD/skills/animate-ui

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

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

문서

스킬: animate-ui

활성화 계약

다음 상황에서 이 스킬을 사용하세요:

  • Animate UI 배포판을 사용하여 애니메이션 UI 컴포넌트를 추가하거나 커스터마이징할 때.
  • shadcn/ui 프로젝트에서 Motion(Framer Motion) 기반 패턴을 구현할 때.
  • Animate UI 레지스트리를 설정하거나 특정 프리미티브/컴포넌트를 추가할 때.

하드 규칙

  • 복사 우선 접근 방식: 항상 컴포넌트를 고정된 라이브러리 임포트가 아닌 "열린 코드"로 취급하여 복사 및 수정해야 합니다.
  • 종속성 확인: 컴포넌트를 추가하기 전에 motion, tailwind-merge, clsx, lucide-react가 설치되어 있는지 확인하세요.
  • 명명 규칙: shadcn CLI 명령어에 대해 @animate-ui/{category}-{sub-category}-{name} 패턴을 따르세요.
  • 임포트 경로: 추가된 모든 컴포넌트와 프리미티브의 기본 경로는 @/components/animate-ui/를 사용하세요.
  • 표준 스택: React, Tailwind CSS, Framer Motion(Motion)을 사용하세요.

결정 게이트

작업액션
새 프로젝트npx shadcn@latest init을 실행한 다음 Tailwind/Motion을 구성합니다.
프리미티브 추가npx shadcn@latest add @animate-ui/primitives-{category}-{name}을 사용합니다.
컴포넌트 추가npx shadcn@latest add @animate-ui/components-{category}-{name}을 사용합니다.
커스텀 모션motion props(예: whileHover, transition)를 사용하여 기존 컴포넌트를 확장합니다.

실행 단계

  1. 전제 조건 확인: package.json에 framer-motion(또는 motion)과 tailwind-merge가 있는지 확인합니다.
  2. 초기 설정: 아직 완료되지 않은 경우 shadcn/ui 초기화 프로세스를 따릅니다.
  3. 컴포넌트 선택: 프리미티브(로직 + 기본 모션)가 필요한지, 컴포넌트(스타일이 적용된 UI 조각)가 필요한지 확인합니다.
  4. 설치: @animate-ui 범위의 패키지 이름과 함께 shadcn CLI를 사용합니다.
  5. 통합: @/components/animate-ui/...에서 가져와서 필요한 props를 전달합니다.
  6. 다듬기: 스프링 전환(stiffness, damping)을 프로젝트 감성에 맞게 조정합니다.

출력 계약

  • shadcn CLI를 통해 추가된 컴포넌트 목록.
  • 구현에서 확인된 임포트 경로.
  • 커스텀 모션 조정 사항이 있다면 그에 대한 설명.

참고 자료

  • references/getting-started.md — 설치 및 설정 가이드.
  • references/components.md — 카테고리 및 명명 규칙.
  • references/motion-patterns.md — 일반적인 스프링 및 전환 설정.

관련 스킬