Codex の shadcn スキル。
shadcn スキルは、メンテナーが意図したとおりに shadcn/ui で作る方法を Codex に教えます。独自のマークアップを書く前にレジストリを探し、コンポーネントを完全な形で組み合わせ、生の色ではなくセマンティックトークンでスタイリングします。OpenAI の Build Web Apps プラグインに含まれています。
2026年11月12日 更新 · 約 3 分で読めます
概要
| スキル名 | shadcn |
| 提供元 | OpenAI の Build Web Apps プラグイン |
| インストール | codex plugin add build-web-apps@openai-curated、または Codex で /plugins |
| Codex が使う場面 | components.json ファイルがあるプロジェクト、または shadcn/ui、レジストリ、--preset コードに触れたとき |
| ソース | GitHub の openai/plugins |
できること
作業を始める前に、このスキルは npx shadcn@latest info --json を実行し、プロジェクトの設定と、すでにインストール済みのコンポーネントを Codex に把握させます。そのうえで 4 つの原則に従います。まず既存のコンポーネントを使う、作り直さずに組み合わせる、独自のスタイルより組み込みのバリアントを先に使う、セマンティックカラーを使う、の 4 つです。
具体的なルールも守らせます。どのルールにも、誤ったコードと正しいコードを載せた参考ファイルがあります。
- スタイリング:
space-y-*ではなくgap-*、w-10 h-10ではなくsize-10、dark:での色の手動上書きはしない、条件付きのクラスにはcn()。 - フォーム: レイアウトには
FieldGroupとField、バリデーションにはdata-invalidとaria-invalid、少ない選択肢にはToggleGroup。 - 構造: dialog、sheet、drawer には必ずタイトルを付ける。card はパーツ一式を使う。avatar には必ずフォールバックを用意する。
- マークアップよりコンポーネント: 注意書きには
Alert、空の状態にはEmpty、読み込み中にはSkeleton、スタイルを付けた span の代わりにBadge、トーストにはsonner。
使いどころ
shadcn/ui を使っているプロジェクトや、これから Codex に shadcn/ui で始めさせたいときに入れましょう。AI が書く shadcn のコードでいちばんよくある問題、つまり見た目は正しくても生の div とハードコードされた色で組み立てられていて、ダークモードで崩れたりテーマからずれたりするコンポーネントを防げます。
試してみる
shadcn スキルを使ってください。shadcn/ui でアカウント設定ページを作ってください。プロフィールのフォーム(名前、メールアドレス、アバター)、通知のスイッチ、確認ダイアログ付きの危険な操作のエリアを入れます。既存のコンポーネントとセマンティックカラーだけを使ってください。
Claude Code でも使える?
指示は標準的な SKILL.md なので、GitHub からフォルダを ~/.claude/skills にコピーできます。ただし、冒頭にある、プロジェクトの情報を差し込む ! コマンドを Claude Code は実行しないので、最初に npx shadcn@latest info を実行するよう頼んでください。