| 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/default 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/default && 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/default && 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/default/components.json).
- Context injection — Use
shadcn info --json as ground truth for imports and APIs.
- Pattern enforcement — Follow rules in
vendor/shadcn/SKILL.md and vendor/shadcn/rules/.
- Component discovery —
shadcn docs, shadcn search, MCP, or registries — see vendored SKILL + MCP doc.
Learn more (web)
Vendored upstream bundle (deep rules)
Snapshot from shadcn-ui/ui skills/shadcn; revision note in vendor/shadcn/UPSTREAM.txt.
Workflow: Prefer this root SKILL.md for repo paths (web/default, Bun). Read vendor/shadcn/SKILL.md for the complete upstream workflow, patterns, and CLI quick reference. Use vendor/shadcn/rules/*.md when validating concrete markup.
