| name | shadcn-ui |
| description | Give the assistant project-aware shadcn/ui context: components.json, composition patterns, CLI, registries, theming, and MCP. Use when working on web UI, shadcn components, or presets. Overview aligns with https://ui.shadcn.com/docs/skills.md; full upstream skill text is vendored under vendor/shadcn/. |
Skills (shadcn/ui)
Skills give AI assistants project-aware context about shadcn/ui. When used, the assistant knows how to find, install, compose, and customize components using the correct APIs and patterns for your project.
For example, you can ask:
- "Add a login form with email and password fields."
- "Create a settings page with a form for updating profile information."
- "Build a dashboard with a sidebar, stats cards, and a data table."
- "Switch to --preset [CODE]"
- "Can you add a hero from @tailark?"
The skill reads your project's components.json and provides your framework, aliases, installed components, icon library, and base library so it can generate correct code on the first try.
Install (ecosystem vs this repo)
Official install from Skills — shadcn/ui:
npx skills add shadcn/ui
That installs the skill where the skills CLI is available. This repository keeps the same intent under .agents/skills/shadcn-ui/ (overview here + vendored upstream docs in vendor/shadcn/) and runs the shadcn CLI from the frontend app root:
cd web && bunx shadcn@latest info --json
Learn more about skills at skills.sh.
What's included (and where)
Project context
Run shadcn info --json (here: cd web && bunx shadcn@latest info --json) for framework, Tailwind version, aliases, base (radix | base), icon library, installed components, and resolved paths.
CLI commands
Full command reference (vendored): vendor/shadcn/cli.md.
Theming and customization
Vendored: vendor/shadcn/customization.md. Live docs: Theming.
Registry authoring
Not duplicated as a single file in the vendor tree; see Registry and build in vendor/shadcn/cli.md.
MCP server
Vendored: vendor/shadcn/mcp.md. Live docs: MCP Server.
How it works
- Project detection — Applies when
components.json exists (here: web/components.json).
- Context injection — Use
shadcn info --json as ground truth for imports and APIs.
- Pattern enforcement — Use
vendor/shadcn/rules/ for concrete markup checks; the complete official workflow reference is listed below for deeper CLI, registry, and preset questions.
- Component discovery —
shadcn docs, shadcn search, MCP, or registries — see the official workflow reference and MCP doc when deeper context is needed.
Learn more (web)
Vendored upstream bundle (deep rules)
Snapshot from shadcn-ui/ui skills/shadcn; revision note in vendor/shadcn/UPSTREAM.txt. The upstream workflow is stored as a reference file, with its original skill frontmatter removed, so the vendored copy is not discovered as a second local skill.
Workflow: Prefer this root SKILL.md for repo paths (web, Bun). Read vendor/shadcn/official-shadcn-ui-workflow.md only when you need the complete official component, registry, or preset workflow. Use vendor/shadcn/rules/*.md when validating concrete markup.
