该技能是面向 AI 智能体与 LLM 的 shadcn/ui 最佳实践指南，用于在编写、审查或维护基于 shadcn/ui 的 React 应用时提供规则参考。内容共 48 条规则，按影响优先级分为 8 类：CLI 与项目设置（CRITICAL，setup-）、组件组合（CRITICAL，comp-）、样式与主题（HIGH，style-）、无障碍模式（HIGH，access-）、表单集成（MEDIUM-HIGH，form-）、数据显示组件（MEDIUM，data-）、布局与导航（MEDIUM，layout-）、性能优化（LOW-MEDIUM，perf-）。
适用时机包括：在项目中安装和配置 shadcn/ui；使用 Dialog、Select、Dropdown 组合组件结构；通过 CSS 变量和深色模式实现主题；构建带校验与错误处理的无障碍表单；集成 TanStack Table 创建数据表格。
主要规则涉及：添加组件前先配置 components.json 与 TypeScript 路径别名、创建 cn 工具函数、使用 CLI 而非复制粘贴、启用 CSS 变量主题；通过编辑组件源码而非包裹来定制、使用 asChild 渲染自定义元素、用 CVA 管理变体；用 cn() 合并类名、遵循 CSS 变量命名、基于 class 切换深色模式、使用 OKLCH 颜色格式；为 Dialog 添加 DialogTitle、为表单控件关联标签、使用 aria-invalid 表示错误、为纯图标按钮提供无障碍标签；集成 React Hook Form 与 Field 组件、用 Controller 处理 Select、提交时禁用按钮；TanStack Table 的列定义独立存放、行操作使用下拉菜单、处理空状态；使用 SidebarProvider 与可折叠侧边栏、移动端用 Sheet 导航、实现面包屑；动态导入重型组件、直接从路径导入 Lucide 图标、稳定回调属性、使用 Skeleton 与虚拟化长列表。
使用方式为阅读各参考文件获取详细说明与代码示例，包括 sections 定义、规则模板、参考文件 _sections.md 与 metadata.json。限制方面，资料未提供具体许可证、依赖版本、安装命令及价格信息，暂未提供。