スキル: 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 のプロパティ(例:whileHover、transition)を使用して拡張します。 |
実行手順
- 前提条件の確認:
package.jsonにframer-motion(またはmotion)とtailwind-mergeが含まれているか確認します。 - 初期設定: まだ完了していない場合は、
shadcn/uiの初期化プロセスに従います。 - コンポーネントの選択: ロジックとベースモーションを含むプリミティブ、またはスタイル付き UI 部品であるコンポーネントのどちらが必要かを特定します。
- インストール:
@animate-uiスコープ付きパッケージ名を使用して shadcn CLI を実行します。 - 統合:
@/components/animate-ui/...からインポートし、必要なプロパティを渡します。 - 仕上げ: プロジェクトの雰囲気に合わせてスプリングトランジション(stiffness、damping)を調整します。
出力契約
- shadcn CLI を介して追加されたコンポーネントのリスト。
- 実装におけるインポートパスの確認。
- カスタムモーション調整がある場合はその説明。
参考資料
references/getting-started.md— インストールとセットアップガイド。references/components.md— カテゴリと命名規則。references/motion-patterns.md— 一般的なスプリングとトランジションの設定。