// 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/.
Inspect a given commit's web/classic changes and sync all features/fixes to web/default. Use when the user provides a commit ID and wants to audit whether web/default already has the same features as web/classic, port missing features, improve suboptimal implementations, fix bugs, and remove redundant code. Trigger phrases include: "/classic-to-default-sync <hash>", "classic-to-default-sync <hash>", "sync classic to default", "port from classic", "compare classic commit", "classic 和 default 对比", "把这次 classic 的修改同步到 default", "查看这次提交 classic 中的修改并同步", or any request supplying a commit hash together with classic/default comparison intent.
Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", or "switch to --preset".
Complete and maintain frontend i18n translations for this project. Covers finding missing translation keys, detecting untranslated entries, and adding translations for all supported locales (en, zh, fr, ja, ru, vi). Use when the user asks to add translations, fix i18n, complete missing translations, or when new UI text needs to be internationalized.
| 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 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:
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.
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.
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.
Full command reference (vendored): vendor/shadcn/cli.md.
Vendored: vendor/shadcn/customization.md. Live docs: Theming.
Not duplicated as a single file in the vendor tree; see Registry and build in vendor/shadcn/cli.md.
Vendored: vendor/shadcn/mcp.md. Live docs: MCP Server.
components.json exists (here: web/default/components.json).shadcn info --json as ground truth for imports and APIs.vendor/shadcn/SKILL.md and vendor/shadcn/rules/.shadcn docs, shadcn search, MCP, or registries — see vendored SKILL + MCP doc.vendor/shadcn/cli.mdSnapshot from shadcn-ui/ui skills/shadcn; revision note in vendor/shadcn/UPSTREAM.txt.
| Doc | Path |
|---|---|
| Full official skill body | vendor/shadcn/SKILL.md |
| CLI reference | vendor/shadcn/cli.md |
| Theming / customization | vendor/shadcn/customization.md |
| MCP | vendor/shadcn/mcp.md |
| Forms | vendor/shadcn/rules/forms.md |
| Composition | vendor/shadcn/rules/composition.md |
| Icons | vendor/shadcn/rules/icons.md |
| Styling | vendor/shadcn/rules/styling.md |
| Base vs Radix | vendor/shadcn/rules/base-vs-radix.md |
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.