Communitygithub.com

creativetimofficial/ui

Creative Tim UIブロックライブラリアシスタント。creative-tim.com/uiのUIブロック・コンポーネント・ページの追加、生成、修正時に使用します。デザイン哲学(ミニマリズム、95%ルール、リサーチファースト)、ブロックの探索、CLIインストール方法、PRO APIキーの設定、Creative Timのデザインルール(オレンジブランド、shadcn/uiベース、Tailwind v4)をカバーします。生成されるブロックは意図的で抑制の効いた、過剰ではないものになります。

ui とは?

このスキルは、Creative Timが提供する390以上のプロダクションレディなUIブロックライブラリを、AIエージェント(Claude Codeなど)から操作・生成・カスタマイズするためのものです。shadcn/uiとTailwind v4をベースに、Next.js、Remix、ViteなどのReactフレームワークと互換性があります。スキルは、ブロックのインストール(Creative Tim CLIおよびshadcn CLIの両方をサポート)、PRO APIキーの設定、そしてCreative Timのデザインルール(オレンジをアクセントカラーに使用、任意値の禁止、テキストサイズの制約など)に沿ったUIコードの生成を支援します。また、「95%ルール」や「Light原則」といったデザイン哲学を重視し、必要最小限で本番品質のブロックを生成するようガイドします。このスキルは、AIエージェントがCreative Timの一貫したデザインシステムを守りながら、迅速にUIブロックをプロジェクトに組み込むために不可欠です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/creativetimofficial/ui/tree/HEAD/skills/creative-tim-ui

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Creative Tim UI

shadcn/ui 上に構築された包括的なブロックライブラリ。40以上のカテゴリにわたる390以上のプロダクションレディなブロックを提供します。すべてのブロックはReact + Tailwind CSSで、Next.js(App Router)、Remix、Viteと互換性があります。

フルライブラリを見る: https://www.creative-tim.com/ui AI可読インデックス: https://www.creative-tim.com/ui/llms.txt

このスキルをインストール

# skills CLIでインストール(推奨)
npx skills add creativetimofficial/ui

# グローバルインストール(全プロジェクトで利用可能)
npx skills add creativetimofficial/ui -g

# 特定のエージェントにのみインストール
npx skills add creativetimofficial/ui --agent claude-code

スキルページ: https://skills.sh/creativetimofficial/ui/creative-tim-ui

デザイン哲学

300以上のプロダクトとカテゴリにわたり、Creative Timは同じ規律を適用してきました。それは、開発者が実際に必要とするものを特定し、それを例外的にうまく構築し、それ以外のすべてを削ぎ落とすことです。この抑制こそがライブラリの中核です。

ブロックを生成または修正する際は、以下の原則に従ってください:

95%ルール — 一般的なケースを例外的にうまく構築します。めったに存在しない問題に対して設定、抽象化、柔軟性を追加しないでください。開発者はブロックを読めば、それが何をするかを即座に理解できるべきです。

「ライト」原則 — ブロックは、追加するものがなくなったときではなく、削除するものがなくなったときに完成します。すべてのラッパーdiv、すべてのプロップ、すべてのアニメーション、すべてのアイコンに疑問を持ってください。それなしでブロックが機能するなら、おそらく不要です。

レンダリング前のリサーチ — この画面を見ている人が何をしようとしているかを問いかけてください。ダッシュボードは、誰かがアクションを起こすために必要な数値を表面化します。フォームは、最も少ない抵抗で情報を収集します。表面ではなく、目的に向けてデザインしてください。

基礎の上に構築する — shadcn/uiのプリミティブ(Card、Table、Button、Badge)は適切に設計され、保守されています。それらを構成してください。再実装しないでください。Creative Timの貢献は、構成と判断にあり、プリミティブにはありません。

デモ用途ではなく実用途 — 基準は「実際のチームがこれを本番アプリに出荷するか?」です。情報を持たない視覚的な複雑さを避けてください。コミュニケーションは装飾に勝ります。

コード例を含む詳細: rules/brand-philosophy.md


適用するタイミング

以下の場合にこのスキルを使用してください:

  • プロジェクトにCreative Tim UIブロックをインストールまたはカスタマイズするとき
  • Creative Timのデザインシステムに適合する新しいブロックを生成するとき
  • 生成されたUIコードをブランド/スタイル準拠についてレビューするとき
  • プレミアムブロックにアクセスするためのPRO APIキーを設定するとき
  • 新しいプロジェクトをCreative Tim UIライブラリを使用するようにオンボーディングするとき

ブロックカテゴリ

カテゴリスラッグ説明
AIエージェントai-agentsチャットインターフェース、アクティビティフィード、ツール使用、文字起こし
ページpagesエージェント管理の全ページレイアウト
アカウントaccountプロフィール、設定、請求管理
認証authenticationログイン、登録、2FAフロー
ヒーローheroランディングページのヒーローセクション
料金pricing料金表と請求プラン
チャートchartsデータ可視化
KPIkpiメトリクスカードとダッシュボード
統計stats統計セクション
テーブルtableソート/フィルタリング付きデータテーブル
Eコマースecommerce商品一覧、カート、チェックアウト
ブログblog記事一覧、投稿レイアウト
お客様の声testimonials社会的証明セクション
...[完全なリストは /ui/llms.txt]

ブロックのインストール

2つの方法が完全にサポートされています。セットアップに合った方を選択してください。

方法1 — Creative Tim CLI(推奨)

npx @creative-tim/ui@latest add <block-name>

最初にプロジェクトを初期化します(Next.js / Vite / Remix / Astroを自動検出):

npx @creative-tim/ui@latest init

例:

npx @creative-tim/ui@latest add hero-01
npx @creative-tim/ui@latest add ai-agent-activity-01
npx @creative-tim/ui@latest add agent-management-list-01

パッケージには名前付きバイナリ(creative-tim-ui、creative-tim)も同梱されています。同じコマンド:

npx creative-tim-ui add hero-01
npx creative-tim add hero-01

方法2 — shadcn CLI(完全なURL)

npx shadcn@latest add https://www.creative-tim.com/ui/r/<block-name>.json

例:

npx shadcn@latest add https://www.creative-tim.com/ui/r/hero-01.json
npx shadcn@latest add https://www.creative-tim.com/ui/r/ai-agent-activity-01.json

どちらの方法でも、コンポーネントのソースコードがプロジェクトにコピーされ、必要なshadcn/uiプリミティブ(Button、Card、Badgeなど)が自動的にインストールされます。

PROブロック(APIキー)

一部のブロックは PRO とマークされており、Creative Tim APIキーが必要です。無料のキーは https://www.creative-tim.com/ui で取得できます。

セットアップ

環境にキーを追加します:

# .env.local
CREATIVE_TIM_UI_API_KEY=pk_live_xxxxxxxxxxxxxxxx

どちらかのCLIを使用するときにキーを渡します:

# Creative Tim CLI
npx @creative-tim/ui@latest add pro-block-name --api-key $CREATIVE_TIM_UI_API_KEY

# shadcn CLI — レジストリ設定を介してAuthorizationヘッダーを設定

または、Creative Tim CLI設定を介してグローバルに設定します:

npx @creative-tim/ui@latest login --api-key pk_live_xxxxxxxxxxxxxxxx

キーを設定した後、PROブロックは無料ブロックと同じようにインストールされます。

デザインルール

各ルールファイルに詳細があります。簡単な概要:

ブランドカラー

  • プライマリアクセント: オレンジ(orange-500 / orange-600)— Creative Timのブランドカラー
  • アクセントカラーとして violet、purple、indigo を決して使用しないでください — これらはAI生成のデフォルトを示します
  • ニュートラルサーフェス: slate、gray、zinc
  • ステータス: emerald(成功)、amber(警告)、red(エラー)、blue(情報)

タイポグラフィ

  • すべての可読ボディコンテンツ(ラベル、説明、テーブルセル、リストアイテム)には text-sm を使用
  • text-xs は次の場合のみ: アバターのイニシャル、font-mono タイムスタンプ、バッジピル(ステータス/優先度)、サイドバーのグループヘッダー(大文字 + tracking-wider)、小さなh-6/h-7アクションボタン
  • text-[10px]、text-[11px]、または任意のフォントサイズ値を決して使用しないでください

Tailwind v4 — 任意値禁止

  • スペーシング/サイジングには数値スケールを使用: h-8、w-12、gap-3、p-4 — 決して h-[32px] を使用しない
  • 幅には標準分数を使用: max-w-sm、max-w-2xl、w-1/2 — 決して max-w-[85%] を使用しない
  • レスポンシブブレークポイントのみ: sm:、md:、lg:、xl: — 決して [@media(min-width:640px)]: を使用しない

コンポーネントパターン

  • コンテンツグループ化には Card > CardHeader + CardContent を優先
  • KPI / 統計カード: CardContent className="px-4 py-0"(py-0、デフォルトのpy-6ではない)
  • オーバーフローする可能性のあるリストには ScrollArea を使用
  • サイドバーナビゲーション: 64(w-64)、border-r、bg-muted/30
  • インライン style={{}} を避ける — 常にTailwindクラスを使用

ハイドレーションの安全性

  • useState の初期化子で new Date()、Date.now()、toLocaleTimeString() を決して使用しないでください
  • SSRセーフな初期状態には静的/ハードコードされた文字列を使用し、useEffect / setInterval 内でライブ値に切り替えてください

完全なデザインガイド

コード例を含む完全なルールについては: AGENTS.md

個別ルール:

rules/install-blocks.md     — CLIインストールのチュートリアル
rules/pro-api-key.md        — PROキーのセットアップと認証
rules/design-brand.md       — ブランドカラーとアイデンティティ
rules/tailwind-rules.md     — Tailwind v4のコーディング制約
rules/component-patterns.md — 推奨コンポーネントパターン
rules/hydration-safety.md   — SSR/CSRハイドレーションルール

このスキルのデプロイ

このスキルはリポジトリの .claude/skills/creative-tim-ui/ にあります。誰でも自身のClaude Codeセットアップにインストールするには、以下を実行します:

claude skill install github.com/creativetimofficial/ui .claude/skills/creative-tim-ui

または、手動でクローンしてシンボリックリンクを作成します:

# スキルディレクトリをプロジェクトにクローンまたはコピー
cp -r path/to/ui-repo/.claude/skills/creative-tim-ui .claude/skills/creative-tim-ui

インストール後、そのプロジェクト内のClaude Codeセッションで /creative-tim-ui としてスキルが利用可能になります。

関連スキル