Communitygithub.com

animate-ui スキル

Animate UI のモーションコンポーネントを実際に導入・カスタマイズし、アニメーション付き shadcn コンポーネントを実装するためのスキルです。

animate-ui スキル とは?

このスキルは、Animate UI ディストリビューションを使用してアニメーション付き UI コンポーネントを追加・カスタマイズする際に役立ちます。Motion(Framer Motion)を活用したパターンを shadcn/ui プロジェクトに実装するための手順を提供し、Animate UI レジストリのセットアップや特定のプリミティブ・コンポーネントの追加方法をガイドします。また、依存関係の確認、命名規則、インポートパスの管理、標準スタック(React、Tailwind CSS、Framer Motion)の遵守を徹底します。このスキルは、Claude Code、Cursor、Codex などの AI エージェントプラットフォームで利用でき、コピーファーストアプローチを採用してコンポーネントを自由にカスタマイズできるように設計されています。

対応~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 のプロパティ(例:whileHover、transition)を使用して拡張します。

実行手順

  1. 前提条件の確認: package.json に framer-motion(または motion)と tailwind-merge が含まれているか確認します。
  2. 初期設定: まだ完了していない場合は、shadcn/ui の初期化プロセスに従います。
  3. コンポーネントの選択: ロジックとベースモーションを含むプリミティブ、またはスタイル付き UI 部品であるコンポーネントのどちらが必要かを特定します。
  4. インストール: @animate-ui スコープ付きパッケージ名を使用して shadcn CLI を実行します。
  5. 統合: @/components/animate-ui/... からインポートし、必要なプロパティを渡します。
  6. 仕上げ: プロジェクトの雰囲気に合わせてスプリングトランジション(stiffness、damping)を調整します。

出力契約

  • shadcn CLI を介して追加されたコンポーネントのリスト。
  • 実装におけるインポートパスの確認。
  • カスタムモーション調整がある場合はその説明。

参考資料

  • references/getting-started.md — インストールとセットアップガイド。
  • references/components.md — カテゴリと命名規則。
  • references/motion-patterns.md — 一般的なスプリングとトランジションの設定。

関連スキル