shadcn
You let Claude add, search, style and fix shadcn/ui components while it follows fixed rules for styling, forms and component structure.
What is shadcn?
shadcn is a skill for Claude Code from the shadcn/ui repository by the shadcn organization that guides Claude when working with shadcn/ui components and projects. It activates on its own once a project contains a components.json file or you talk about registries, presets or design systems. At the start it reads the project configuration and installed components with 'npx shadcn@latest info'.
The skill gives Claude fixed rules: search for existing components with 'npx shadcn@latest search' first, build pages from existing building blocks, and use built-in variants and semantic color tokens. Separate rule files with incorrect and correct code examples cover Tailwind styling, forms, component structure, icons and chat interfaces.
It suits teams that build React interfaces with shadcn/ui or want to derive a design system from a DESIGN.md or a brand spec. You need a package runner such as npx, pnpm dlx or bunx, because every command goes through the shadcn CLI. The skill is released under the MIT license.
Who it is for
Frontend developers and design engineering teams who build and maintain React interfaces with shadcn/ui and Tailwind.
Use cases
- You are building a settings page or a dashboard and want Claude to use existing shadcn/ui components instead of custom div structures.
- You set up shadcn/ui in a new project with a template such as vite or next and want to apply a preset right away.
- Your team has a DESIGN.md or a brand spec and wants to turn it into a theme and a design system page for shadcn/ui.
What shadcn does
Project context via CLI
On load the skill reads the configuration and installed components with 'npx shadcn@latest info'. Claude then knows the project base, Radix or Base UI, and which package manager to use.
Search before building
Before writing custom UI, Claude checks registries with 'npx shadcn@latest search', including community ones, and composes pages from existing components such as Tabs, Card, Sidebar and Table.
Rules for styling and forms
Semantic tokens instead of raw color values, gap instead of space-y, FieldGroup and Field for forms, data-invalid and aria-invalid for validation. Each rule comes with an incorrect and a correct example.
Chat interfaces from primitives
For chats Claude uses MessageScroller, Message and Bubble, Attachment for files, and a Trace with TraceLine entries for reasoning steps, tool calls and sources.
Presets through the CLI
Claude applies preset codes to existing projects with 'npx shadcn@latest apply' or sets them during setup with 'npx shadcn@latest init --preset', without decoding codes by hand.
Design system from DESIGN.md
A dedicated workflow scaffolds an app from a preset, installs all components, restyles them from a DESIGN.md and generates a design system page showing colors, components and states.
Say this to activate the skill
"Set up shadcn/ui in this project.""Add a sign-in form using shadcn components.""Apply this DESIGN.md to our shadcn/ui project.""Build me a chat interface with shadcn." Install
npx skills add shadcn/ui --skill shadcn
The command installs the original version from the author's repository (Vercel skills CLI, needs Node.js), add -g for all projects. We do not host a copy: updates come straight from the author. Need help with setup? How to install skills →
Checked automatically
- Automated check on 2026-11-06 (revision 8a35366): 19 files in the skill folder read by pattern search. It found no hidden characters, no instructions to override rules, no download-and-run and no access to credentials.
Independent checks on skills.sh, as of 6 Nov 2026
| Gen Agent Trust Hub | Pass |
|---|---|
| Socket | Warn |
| Snyk | Pass |
Good to know
- shadcn runs 'npx shadcn@latest info' on load, which executes the latest CLI version from the package registry each time.
- According to its tool permissions, the skill may only run the shadcn CLI through npx, pnpm dlx or bunx. Other commands are not allowed.
- shadcn activates automatically and cannot be called as a slash command. It responds to projects with components.json and terms like preset or registry.
- The CLI copies components into your project as source code. From then on they are part of your own codebase.
- One auditor on skills.sh reports a warning (Socket). Read its notes before bringing the skill into projects with sensitive data.
- The check is an automated pattern search, not a security guarantee, and reads the skill folder only. The command always installs the author's current version; later versions have not been reviewed by us.
Frequently asked questions about shadcn
What is shadcn?
shadcn is a Claude skill from the shadcn/ui repository that guides Claude in adding, searching, styling and fixing shadcn/ui components. It provides project context, component documentation and rules with code examples.
How do I install shadcn?
You install shadcn with 'npx skills add shadcn/ui --skill shadcn'. After that the skill activates automatically when you work in a project with components.json or mention shadcn/ui. It has no slash command of its own.
Is shadcn free?
Yes, the shadcn skill is released under the MIT license. To run its commands you need a package runner such as npx, pnpm dlx or bunx, which calls the shadcn CLI.
Who is shadcn for?
shadcn is for anyone building interfaces with shadcn/ui who wants Claude to use existing components, built-in variants and semantic tokens. Teams deriving a design system from a DESIGN.md get a dedicated workflow.
What data does shadcn send?
shadcn calls the shadcn CLI through npx, pnpm dlx or bunx, which fetches the latest version of the package and queries registries when searching. The skill itself does not describe which project data the CLI transmits.
Share this skill
About this skill
shadcn comes from shadcn and is an open-source project maintained by its author and community.
Author: shadcn / github.com. Source: github.com/shadcn/ui/tree/main/skills/shadcn. Licence: MIT.
Curated by Collective Brain, an AI and automation digital agency from Hamburg, together with WhiteFox Automations. More vetted skills in the skills catalog.
Working in Germany, Austria or Switzerland? We help teams roll out Claude, in English or German.
Want this skill tailored to your team?
shadcn is a strong starting point. A skill gets really powerful once it knows your workflows, templates and tone of voice. We build custom skills for teams, from analysis to rollout, and connect them to our work in web development and interface design.
Request a custom skill →