用途:该技能面向 shadcn/ui 的注册表与配置管理,覆盖 components.json 结构(style、Tailwind 路径、别名)、命名空间注册表、GitHub 注册表、动态注册表、预设以及 shadcn CLI 命令。
主要能力:记录 components.json 的 schema(style、tailwind 的 config/css/baseColor/cssVariables、rsc、aliases 的 utils/components);支持 @shadcn 默认注册表、目录注册表(如 @basecn)、自定义命名空间("registries": {"@acme": "https://.../{name}.json"} 或 registry add @acme=<url>)、GitHub 注册表(add owner/repo/item[#ref])。样式格式为 {base}-{style},base 可为 base、radix、aria,style 可为 vega、nova、maia、lyra、mira、luma、sera、rhea;初始化后不能改 style,需用 apply --preset 切换设计。
使用方式:先检测包管理器,{runner} 为 bunx | npx | pnpm dlx | yarn dlx。常用命令包括 {runner} shadcn@latest init(可加 -b radix、-t vite、--preset、--rtl、--monorepo、--defaults)、add(支持 --dry-run、--diff、--view)、apply --preset、preset decode|resolve|url|open、info --json、docs、search/list、view、migrate cn|icons|base-color|radix|rtl、eject、mcp init --client claude,以及 build、registry validate、registry add。添加组件前应通过 MCP(mcp__shadcn__search_items_in_registries、mcp__shadcn__get_add_command_for_items)查询。
适用场景:初始化或维护 shadcn/ui 项目、配置多注册表、添加组件、迁移旧项目、生成注册表。
限制:不得在同一项目混用组件基座(Base UI/Radix/React Aria);components.json 须与实际基座保持同步;添加组件必须用 CLI,不能手动复制;第三方 GitHub 项应固定 tag 或完整 SHA 并先审查。资料未提供收费、价格或平台支持信息。