Skip to main content
skill CX Codex

shadcn-ui · podo — Claude Code skill: what it does, how to install

Guides AI coding agents through searching, adding, and composing shadcn/ui components accurately.

MIT 271 installs ★ 35 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill shadcn-ui -a claude-code
Open on GitHub

What shadcn-ui does

This skill establishes a structured shadcn/ui workflow tailored to your project. The assistant inspects project settings by executing npx shadcn@latest info --json, queries official and community registries, and installs items using proper CLI arguments. Instead of introducing arbitrary CSS classes, it relies on existing variants and design tokens.

Node.js is strictly required because the workflow invokes shadcn via your local package runner. You also need a components.json configuration file present in the project root, or you must initialize one via shadcn init.

A known naming overlap exists: google-stitch-skills provides a pointer using the same shadcn-ui name, meaning installing both overwrites the previous setup.

What it helps with

  • add missing shadcn components via CLI without manual copy-paste
  • compose complex layouts like settings views from Cards and Tabs
  • resolve styling mismatches by using semantic theme variables
  • integrate custom presets and external component registries

Example prompts for the agent

  • Add a shadcn component for user avatar dropdown
  • Check our components.json and build a checkout form with shadcn/ui
  • Fix invalid variant styles in this ui component

How to install shadcn-ui

1Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill shadcn-ui -a claude-code

2Manually: put the files in place

~/.claude/skills/shadcn-ui/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/shadcn-ui/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about shadcn-ui

How to install shadcn-ui in Claude Code?

Run npx skills add podo/design-agent-skills --skill shadcn-ui -a claude-code in your terminal. It puts the skill configuration into ~/.claude/skills/shadcn-ui/SKILL.md.

What does shadcn-ui do?

It orchestrates shadcn/ui component discovery, installation, and composition while checking local configurations to avoid common styling mistakes.

What are the runtime requirements?

You need Node.js installed to execute npx shadcn commands, roughly 71 MB of disk space, and a project initialized with components.json.

Source text

SKILL.md · MIT
---
name: shadcn-ui
description: |
  Project-aware shadcn/ui workflow for searching, adding, composing, and fixing
  components with correct patterns. Reads the local project's shadcn config and
  installed components and avoids common shadcn anti-patterns during implementation.
triggers:
  - "shadcn"
  - "shadcn/ui"
  - "shadcn component"
  - "ui component"
das:
  category: visual-components
  upstream: "https://github.com/shadcn-ui/ui"
  upstream_path: "skills/shadcn/SKILL.md"
  version: latest
  install: true
---

# shadcn-ui

> Catalogue stub — full skill: [shadcn-ui/ui](https://github.com/shadcn-ui/ui) (`skills/shadcn`)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   Upstream names this skill `shadcn`, so it installs next to this pointer (the pointer is not replaced).
   - Global: `f=~/.agents/skills/shadcn/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/shadcn/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `shadcn`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/shadcn-ui ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add shadcn-ui/ui --skill shadcn -g -y
   ```

   **Project:**
   ```bash
   npx skills add shadcn-ui/ui --skill shadcn -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Heads-up**

- **Requires:** Node.js: the skill runs the shadcn CLI through your package runner (`npx shadcn@latest ...`, fetched from npm at use time), including `info --json` for project context; A project with a components.json file (or one you are about to create with `shadcn init`)
- **License:** MIT
- **Download size:** ~71 MB.
- **Name collision:** `shadcn-ui` is also written by `google-stitch-skills` (its install or its catalogue pointer); installing both overwrites the earlier one.
<!-- das:install:end -->

## Invoke after install

- Skill name: `shadcn`
- Trigger phrases: "shadcn", "shadcn/ui", "shadcn component", "ui component"

## What it does

Provides a project-aware workflow for working with shadcn/ui: searching the available component registries (including community registries), adding components with the correct CLI command, composing components from existing ones (a settings page is Tabs + Card + form controls), using built-in variants and semantic colors before custom styles, and fixing common implementation mistakes. It also covers presets, registries and design-system pages. The skill loads project context by running `npx shadcn@latest info --json`.

The same upstream repository ships a separate `migrate-radix-to-base` skill for moving components from Radix UI to Base UI; it is not part of this stub (add it with `npx skills add shadcn-ui/ui --skill migrate-radix-to-base`).

## When NOT to use

- A non-shadcn component library, or a design system built from scratch — use `design-consultation`
- Google Stitch to shadcn conversion — use `google-stitch-skills`

© podo · MIT · podo/design-agent-skills

Similar skills

All skills for Frontend and UI →

shadcn-ui by other authors comes first.

shadcn-ui official google-labs-code Helps discover, add, and customize shadcn/ui components in React projects. Useful when building interfaces with Tailwind CSS. CX Codex +1 55,400installs shadcn-ui nexu-io Builds UI components with shadcn/ui. Works alongside the Stitch design loop to ship structured, accessible components. CX Codex +1 3,100installs shadcn-ui giuseppe-trisciuoglio Tells the agent how to install and configure shadcn/ui components: buttons, dialogs, tables, and forms with React Hook Form and Zod. CX Codex +1 22,800installs shadcn-ui jezweb Installs and configures shadcn/ui components in a React project: picks them by task, keeps install order and dependencies straight. CX Codex +1 3,600installs shadcn-ui existential-birds Teaches the agent shadcn/ui component patterns — CVA variants, compound components, data-slot attributes. Fires on Button, Card, Dialog, cn() and Radix primitives. CX Codex +1 358installs tailwind-v4-shadcn secondsky tailwind-v4-shadcn sets up Tailwind CSS v4 with shadcn/ui, Vite, and React. Solves broken CSS variables, theme switching errors, and v4 migration pitfalls. CX Codex +1 8,300installs 21st-dev-builder-v2 trin-zenityx 21st-dev-builder-v2 — a skill that walks the agent through the 21st.dev registry: it finds components, picks the fitting ones and assembles pages and apps in React and Tailwind. CX Codex +1 474installs shadcn-inertia inertia-rails shadcn-inertia adapts shadcn/ui components for Inertia.js Rails React applications instead of Next.js. Guides form wiring, dialogs, and dark mode without react-hook-form. CX Codex +1 441installs json-render-shadcn vercel-labs json-render-shadcn is a Claude Code skill that adds ready-made shadcn/ui components to json-render catalogs and web UIs. It activates for work with @json-render/shadcn. CX Codex +1 257installs shadcn-code-review existential-birds shadcn-code-review audits React components built with shadcn/ui, Radix primitives, and Tailwind CSS. Catches CVA mistakes, broken asChild slots, and missing accessibility states. CX Codex +1 206installs cursor-ai-react-typescript-shadcn-ui-cursorrules-p PatrickJS cursor-ai-react-typescript-shadcn-ui-cursorrules-p — a Cursor rule that pushes the agent toward React and TypeScript code written the way shadcn/ui and Tailwind CSS projects expect. CX Codex +1 ★ 41,178repo stars

From the same set108

The whole set →
interaction-design Hands the agent a working reference for interaction design: flows, component states, micro-interactions and handoff notes. CX Codex +1 284installs anthropics-skills anthropics-skills is a Claude Code skill that installs six official Anthropic skills for UI work, HTML artifacts, graphics, themes, brand guidelines and PowerPoint. CX Codex +1 280installs antvis-chart-skills antvis-chart-skills is a Claude Code skill for creating charts, diagrams, and infographics with AntV, including data visualization and turning text into diagrams. CX Codex +1 277installs figma-official-skills figma-official-skills is a Claude Code skill package that moves Figma designs into code, builds design-system libraries and links Figma components to repository components. CX Codex +1 271installs deanpeters-pm-skills deanpeters-pm-skills — a skill for Claude Code, Codex and Cursor: nine product management techniques — NNGroup customer journey maps, Lean UX Canvas, Teresa Torres opportunity-solution trees, proto-personas, user story mapping. CX Codex +1 270installs textual-tui-skill textual-tui-skill is a Claude Code skill for building Python terminal interfaces with Textual, covering widgets, styles, background tasks, and tests. CX Codex +1 268installs remotion remotion is a Claude Code skill for building videos from React components, with spring-driven motion and export to MP4, WebM or GIF. CX Codex +1 265installs user-research-cookiy user-research-cookiy is a Claude Code skill for planning user research, creating discussion guides, and synthesizing transcripts in an agent workspace. CX Codex +1 264installs

Project sponsors

Companies that keep this analytics open