1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | shadcn-shadcn-ui-ui |
| 项目自述名称 | shadcn(SKILL.md front matter 内 name 字段原值;官方文档站将该功能统称为 “Skills”) |
| 作者/维护者 | shadcn(个人身份,创建 shadcn/ui 项目,现于 Vercel 任职);托管于 shadcn/ui 官方仓库 |
| 来源链接 | https://github.com/shadcn-ui/ui/tree/main/skills/shadcn |
| 许可证 | MIT(仓库级,GitHub API 实测) |
| GitHub Stars/Forks | 所属仓库 119,053 / 9,490(GitHub API 实测;按合集仓库规则,此数字不代表该子技能自身热度,仅供参考;子技能自身热度另见第三方目录站证据) |
| 最新版本 | 无独立版本号,随主仓库持续滚动更新;GitHub API 实测最近一次提交 2026-07-13;第三方目录站 agenticskills.io 记录本子技能自身最近一次更新为抓取时间点前约 9 小时 |
| 安装方式 | 一键:pnpm dlx skills add shadcn/ui;或手动下载 SKILL.md 到本地 skills 目录 |
2. 功能介绍与亮点
这是 shadcn/ui 官方仓库自带的 Agent Skill,教 Agent 如何正确地增、删、查、改、组合 shadcn/ui 组件。
核心能力:
- 项目感知注入:检测到项目含
components.json时自动激活,运行shadcn info --json把框架类型、Tailwind 版本、路径别名、RSC 状态、图标库等配置注入 Agent 上下文,避免生成与项目实际配置不符的代码 - CLI 优先,禁止手抄:一律通过
npx/pnpm dlx/bunx shadcn@latest官方 CLI 操作组件,优先用--dry-run/--diff预览,禁止手动从 GitHub 拼凑文件 - 分领域细则文档:forms(表单校验态)、composition(组合模式)、icons(图标规范)、styling(语义化 token)、base-vs-radix(底层库选型)等参考文件,覆盖组合类 UI 最易出错的细节
- Registry 显式确认:添加组件/区块前要求先与用户确认来源 registry,不假设默认值
亮点:作者本人在 Vercel 直接维护、随 CLI 大版本(如 Tailwind v4)同步更新、已被第三方 Skill 目录站 agenticskills.io 评为 “S-rank”。
3. 适用场景
固定分类:前端与设计。
适合用 shadcn/ui 搭建产品界面的初中级前端开发者;适合团队里想统一沿用 shadcn 组合规范、避免不同 Agent 会话各写各样式导致漂移的场景;也适合需要从设计稿或自然语言描述快速拼装落地页、后台 Dashboard、电商流程等复合型界面的用户。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——本体就是标准 SKILL.md,官方文档给出专门的 Claude Code 安装路径
- Codex:✅ 兼容——第三方目录站 agenticskills.io 明确列出该 Skill 兼容 Codex
- OpenClaw:未验证——未抓取到相关证据
- Hermes Agent:未验证——未抓取到相关证据
5. 推荐理由
shadcn/ui 是目前 React/Next.js 生态里采用最广的组件方案之一,但实践中 Agent 容易“组件装上了但用法不对/风格跟项目 token 对不上/表单聊天等复合场景拼错”。这个官方 Skill 把项目实际配置直接注入 Agent 上下文,并用分领域规则文档约束 Agent 遵循 shadcn 自身的组合范式,同时强制走 CLI 而非手抄文件,能显著降低“Agent 自由发挥导致组件风格跑偏”的风险。作为作者本人在 Vercel 维护的官方产物、随 CLI 版本同步更新、一条命令即可安装,是前端与设计类目里少见的“官方出品 + 高知名度母项目 + 多平台已收录”叠加的候选。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9.0 | 官方出品(一线机构/知名开发者产物),且已被 skills.sh、agenticskills.io(S-rank)、LobeHub、webdeveloper.com 等多个独立第三方目录站收录,满足“官方出品 + 多平台大量独立收录”档位;未给满分是因为该子技能自身单独的 star/issue 数据无法从母仓库剥离验证 |
| 可用性 | 9.0 | 一条命令安装(pnpm dlx skills add shadcn/ui),检测到项目即自动激活;文档拆分详尽(forms/composition/icons/styling 等专项参考文件);母仓库最近一次提交为抓取前一日,维护极活跃 |
| 安全性 | 9.0 | 见下方安全检查清单 |
| 综合 | 9.0 | 三项均值,远超 7.0 达标线,安全性远超一票否决线 |
安全检查清单:
- Shell/权限范围:仅可执行
npx shadcn@latest */pnpm dlx shadcn@latest */bunx --bun shadcn@latest *三种模式命令,严格限定为 shadcn 官方 CLI,非任意 shell - 联网外发:CLI 会从配置的 registry(默认 npm/shadcn 官方 registry)拉取组件代码,这是工具本身设计的核心功能、行为公开透明;SKILL.md 明确要求“显式确认 registry 来源,不得默认假设”
- API Key/凭据:未见任何要求提供 API key 或凭据的指令
- 可疑指令/注入迹象:完整抓取 SKILL.md 全文核实,未发现要求执行流程外操作、访问敏感文件或篡改 Agent 行为的可疑指令
- 作者/组织信誉:shadcn 本人(shadcn/ui 创建者)在 Vercel 维护,身份可验证、信誉高
- License:MIT,明确清晰
- 维护时间:母仓库最近一次 push 为抓取前一日(2026-07-13);第三方目录站记录该子技能自身最近更新为抓取前约 9 小时,活跃度高
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 核心差异 |
|---|---|---|
| shadcn(本次推荐) | 官方 shadcn/ui 组件 CLI 技能 | 官方出品、项目配置感知注入、CLI 优先强约束、多平台已收录 |
| Shadcnblocks-Skill(候选,本次未选) | 2,500+ 预制 shadcn 区块选装 | 第三方个人项目,聚焦“整块拼装”而非底层组件治理,star 数与维护证据均薄弱 |
| design-system-ops(候选,本次未选) | 设计系统治理审计(token-audit、drift-detection 等) | 面向已有成熟设计系统的“看护”场景,而非从零安装组件,与本技能定位互补 |
| shadcn-skills(mattbx,候选,本次未选) | 检索已有 1,500+ 组件 + 按主题风格审查 | 侧重“复用已有组件避免重复造轮子”,功能范围比官方 CLI 技能窄 |
| brand-guidelines(anthropics/skills 同类候选,本次未选) | 套用 Anthropic 品牌色/字体到产出物 | 场景锁定于套用固定品牌视觉规范,与本技能“组件级工程能力”定位完全不同 |
8. 用户评价
本次仅抓取到 1 条经独立验证的社区评价:技术博客作者 Ramu Narasinga 在其关于该项目 skills 目录结构的文章中评价其 Workflow 章节“清楚展示了如何一步步管理 Shadcn 代码库”,并指出其 user-invocable: false 等元数据字段设计、以及在多个仓库间共享 “Principles” 章节的写法正成为新兴最佳实践。第三方目录站 agenticskills.io 将其评为 “S-rank” 但未提供具体评论文本。如实说明:本次未收集到更多一手用户评价。
9. 其他补充
该 Skill 已被多家第三方 Claude Skill 聚合/市场站点收录索引,包括官方 skills.sh 平台、agenticskills.io、LobeHub、webdeveloper.com 等,反映其在 Skill 生态中已形成一定的多平台可见度。
10. 安装使用方式
- 通过 skills.sh 平台一键安装:
pnpm dlx skills add shadcn/ui - 或手动下载:
mkdir -p ~/.claude/skills/shadcn && curl -fsSL https://raw.githubusercontent.com/shadcn-ui/ui/main/skills/shadcn/SKILL.md -o ~/.claude/skills/shadcn/SKILL.md(如需完整规则文档,建议连同skills/shadcn/目录下的cli.md、rules/等参考文件一并复制) - 安装后,在含
components.json的 shadcn/ui 项目中新开对话即会自动激活并注入项目上下文,无需额外重启操作 - 触发方式:提出组件相关需求(如“帮我加一个带校验的表单”)、运行
shadcn init、粘贴 preset 代码或使用--preset参数均可触发
11. 注意事项
- 需要项目已初始化
components.json(即已是 shadcn/ui 项目)才会自动激活,非 shadcn 项目用不上 - 受欢迎程度评分基于官方身份与第三方多平台收录情况估算:该技能所在仓库是 shadcn/ui 主代码库而非独立 skill 仓库,其 119k stars 不能直接算作该子技能自身热度指标(已在评分说明中注明)
- 未对 OpenClaw、Hermes Agent 做过兼容性验证,如需在这两个生态使用请自行测试
- 使用组件时 CLI 会从配置的 registry 联网拉取代码,如在网络受限或对第三方 registry 有合规顾虑的环境中使用,需自行确认 registry 来源可信