shadcn/uiとは?
shadcn/uiはインポートして使うパッケージではありません。CLIが各コンポーネントのソースコードをプロジェクトにコピーし、そのコードはあなたのものとして編集できます。同じCLIでサードパーティやプライベートのregistryからも項目を取り込めます。コンポーネントはRadix、Base UI、React Ariaのいずれかを土台にし、スタイルはTailwindです。セットアップガイドはNext.js、Vite、Laravel、React Router、Astro、TanStack Startに対応しています。
リポジトリにはagent skillsも含まれます。SKILL.mdを収めたフォルダで、コーディングエージェントが必要なタスクのときに読み込みます。メインのスキルshadcnは`shadcn info --json`でcomponents.jsonを読み、フレームワーク、Tailwindのバージョン、エイリアス、アイコンライブラリ、ベースライブラリ、インストール済みコンポーネントをエージェントに渡し、組み合わせ方のルールも伝えます。もう一つのスキルmigrate-radix-to-baseは、プロジェクトをRadixからBase UIへ移行します。インストールはVercelのskills CLIで行います:`npx skills add shadcn/ui`。
リポジトリは2023年1月に作成され、スターは約128,470、フォークは11,417です。CLIの最新リリースはshadcn@4.23.0(2026年10月27日)で、最新のコミットは2026年11月17日です。
shadcn/uiは使う価値があるか?
このスキルは見た目以上に重要です。shadcn/uiはコーディングエージェントがすでに好んで使うライブラリであり、細部で最も間違えやすいライブラリでもあるからです。学習データを頼りに書くエージェントは、フォームの項目をspace-y-4付きのdivに積み、bg-blue-500で色を上書きし、スクリーンリーダーに必要なDialogTitleを忘れがちです。shadcnスキルは、まさにその癖に対する成文化されたルール集です。フォームはFieldGroupとFieldに入れ、2〜7個の選択肢はToggleGroupを使い、色はセマンティックトークンから取り、Dialog、Sheet、Drawerには必ずタイトルを付けます。各ルールは誤りと正解のコード例を並べたファイルにリンクしています。
もう半分はプロジェクトの文脈です。スキルは読み込まれると`shadcn info --json`を実行し、実際の設定をエージェントに渡します。プロジェクトがRadix、Base UI、React Ariaのどれを使うかも含まれ、これによってカスタムトリガーのAPIが変わります。そのうえで、手書きする前に`shadcn search`、`shadcn docs`、`add --diff`を使うよう促し、registryは推測せずに尋ねるよう指示します。スキルには8件のテストプロンプトを収めたevalsファイルがあり、多くのコミュニティ製スキルより規律があります。
インストールはプロジェクト内で`npx skills add shadcn/ui`を実行するだけです。Vercelのskills CLIは手元のエージェントを検出し(Claude Code、Codex、Cursor、OpenCodeほか75種を挙げています)、ファイルの置き場所を尋ねます。-gを付けると全プロジェクトにインストールされます。skills.shではshadcnスキルが約152,400回、移行スキルが 約38,500回インストールされています。ドキュメントはClaude Codeでの使い方を説明しています。リポジトリには小さなagents/openai.ymlもあり、Codexでスキル名とアイコンが表示されます。別途のMCPサーバーは`npx shadcn@latest mcp init --client claude`(またはcursor、vscode、codex、opencode)で設定し、エージェントがregistryを閲覧してインストールできるようにします。スキルはこのサーバーの使い方も教えます。
セキュリティ上のトレードオフは具体的です。スキルはnpx、pnpm dlx、bunx経由で`shadcn@latest`を実行するシェルコマンドを事前承認するため、Claude Codeではエージェントがaddを含むCLIを確認なしで実行でき、@latestはその日にnpmが配信するバージョンを意味します。コミュニティのregistryから来たコンポーネントはソースコードとしてプロジェクトに入ります。スキルは後でそれを読むようエージェントに指示しますが、それは助言であって検査ではありません。skills CLIはDISABLE_TELEMETRY=1を設定しない限り、匿名のインストールテレメトリを送信します。
ライブラリとしての方式は約4年を経ても通用しています。読みやすいコードが手に入りロックインもない代わりに、保守という代価を払います。コピーしたコンポーネントは自動では更新されないからです。未解決のissueとプルリクエストが1,746件あることから、プロジェクトの活発さがわかります。エージェントを使うReactチームにとって、スキルは追加の手間が小さく、このコードでエージェントが最もよく犯す誤りを正します。shadcn/uiを使っていない人には何の役にも立ちません。
真価を発揮する場面
Claude CodeでNext.jsのSaaSダッシュボードを作る一人創業者
フォームを一つずつ手直しせずに、統一感のある設定ページとデータテーブルを作りたい
`npx skills add shadcn/ui`を一度実行し、ページを依頼します。エージェントはプロジェクト設定を読み、CLIでTabs、Card、フォーム部品を追加し、FieldGroupのルールに従います。通常のモデル利用料以外の費用はかかりません。
社内コンポーネントregistryを持つ20人規模のプロダクトチームのフロントエンドリード
エージェントに新しい部品を作らせず、自社ブランドのコンポーネントを使わせたい
プライベートregistryをcomponents.jsonに追加し、認証用の変数を.env.localに置き、スキルとMCPサーバーをインストールします。エージェントはマークアップを書く前にregistryを検索します。どのregistryを使うか尋ねるというスキルのルールにより、公開項目に流れるのを防げます。
Radixベースの古いshadcn/uiプロジェクトを抱えるチーム
ビルドを壊さずにBase UIへ移行したい
migrate-radix-to-baseスキルは`shadcn info`でベースライブラリを確認し、クリーンなgitツリーを求め、まず型チェックを走らせ、1コミットにつき1コンポーネントずつ移行します。最後の1つが移るまでRadixはインストールしたままです。
導入前に確認すること
- 導入
- `npx shadcn@latest init`(またはテンプレート)でプロジェクトを初期化し、プロジェクトのルートで`npx skills add shadcn/ui`を実行します。skills CLIにはNode.js 22.20以降が必要です。MCPサーバーは任意で、`npx shadcn@latest mcp init --client <agent>`で設定します。Codexではconfig.tomlを手で編集する必要があります。
- 連携
- スキルはVercelのskills CLIでClaude Code、Codex、Cursor、OpenCodeなどのエージェントにインストールします。MCPサーバーはClaude Code、Cursor、VS Code(Copilot)、Codex、OpenCodeに対応。registryは公式、コミュニティ、認証付きのプライベートに対応します。
- データとプライバシー
- ホスト型サービスのないフロントエンドライブラリです。スキルはshadcn CLIをローカルで実行します。skills CLIは匿名のインストールテレメトリを送信します(DISABLE_TELEMETRY=1またはDO_NOT_TRACK=1で無効化)。プライベートregistryのトークンは.env.localに置かれます。
- 大規模利用時のコスト
- 規模にかかわらず無料です。実際のコストはコピーしたコンポーネントの保守と、スキルが読み込まれるたびに加わるコンテキストです。1回あたりのトークン消費量は公開されていません。
- 制限
- React専用で、Tailwindを前提としています。スキルはcomponents.jsonファイルで起動するため、それがないプロジェクトでは何もしません。ドキュメントはClaude Codeでの流れを示しており、スキルに埋め込まれた`shadcn info`コマンドを他のエージェントがどう扱うかは文書化されていません。
良い点
- コンポーネントのソースが自分のリポジトリにあり、戦うべきランタイム依存がない
- エージェントがコードを書く前に、スキルが実際のプロジェクト設定を読む
- 誤りと正解の例を伴う具体的な構成ルール
- 1つのインストールコマンドでClaude Code、Codex、Cursorほか数十のエージェントに対応
- MITライセンス。スキル、CLI、MCPサーバーは無料
気になる点
- スキルがバージョン固定なしの`npx shadcn@latest`コマンドを事前承認する
- コピーしたコンポーネントは手動で更新が必要
- サードパーティregistryのコードを確認するのはエージェントだけで、それも確実ではない
- ReactとTailwind専用
おすすめの人
コーディングエージェントにUIを作らせ、その出力をshadcn/ui自身の規約に沿わせたいReactとTailwindのチーム。
shadcn/uiの代替
shadcn/ui:よくある質問
- shadcn/uiは使う価値があるか?
- Reactアプリに自分で所有するコンポーネント層を持たせる標準的な方法であり続けており、そのエージェント用スキルは、ライブラリが自らのルールをコーディングエージェントに教える例としてこれまでで最も明快です。 評価は5点満点中4.5点です。
- shadcn/uiの料金は?
- MITライセンスで無料です。有料プランはありません。スキルも無料です。
- shadcn/uiの欠点は?
- スキルがバージョン固定なしの`npx shadcn@latest`コマンドを事前承認する; コピーしたコンポーネントは手動で更新が必要; サードパーティregistryのコードを確認するのはエージェントだけで、それも確実ではない; ReactとTailwind専用.
- shadcn/uiは誰に向いているか?
- コーディングエージェントにUIを作らせ、その出力をshadcn/ui自身の規約に沿わせたいReactとTailwindのチーム。
- チームや本番環境でshadcn/uiを使うと費用はいくらか?
- 規模にかかわらず無料です。実際のコストはコピーしたコンポーネントの保守と、スキルが読み込まれるたびに加わるコンテキストです。1回あたりのトークン消費量は公開されていません。
- shadcn/uiは企業データを扱っても安全か?
- ホスト型サービスのないフロントエンドライブラリです。スキルはshadcn CLIをローカルで実行します。skills CLIは匿名のインストールテレメトリを送信します(DISABLE_TELEMETRY=1またはDO_NOT_TRACK=1で無効化)。プライベートregistryのトークンは.env.localに置かれます。
- shadcn/uiの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はAstryx, Impeccable 、 Anthropic Skillsです。
回答確認日:2026年11月18日