VeanUI
v0.51.3
开始使用

Skills

安装 VeanUI skills，让 AI 编码代理能够更稳定地理解组件用法、主题系统、aria 组合模式以及生成式参考资料。

什么是 Skills？

Skills 是提供给 AI 编码代理的结构化知识文件。它们会把特定库的指导、流程和参考资料打包起来，让代理在任务命中时按需加载正确上下文。

它和 MCP server 不同。Skills 不提供实时工具调用，而是把整理好的说明和参考内容直接放进模型上下文。

VeanUI 目前公开提供两个 skill：

  • vean-ui：面向样式层包的使用方式、主题配置、文档导航与生成组件参考
  • vean-aria：面向 aria primitives、Compact 模式、组合方式与共享组件参考

VeanUI skills 覆盖什么

这些 skill 可以帮助 AI 代理处理下列问题：

  • 什么时候该使用 @vean/ui，什么时候该使用 @vean/aria
  • 如何配置主题、语言和方向
  • 如何高效使用组件 API 与生成参考资料
  • 如何把 aria primitives 组合成自定义样式包装层
  • 如何在不加载整站文档的前提下导航文档与参考内容

使用方式

Skills CLI

最直接的安装方式是使用 skills CLI：

npx skills add soybeanjs/vean-ui/skills

你也可以指定目标代理：

npx skills add soybeanjs/vean-ui/skills --agent cursor
npx skills add soybeanjs/vean-ui/skills --agent claude-code

如果希望全局安装，使其在多个项目里都可用：

npx skills add soybeanjs/vean-ui/skills --global

安装这个包会同时提供 vean-ui 和 vean-aria。

Skills URL

如果你的工具支持直接添加 skill URL，可以直接指向公开的 GitHub skill 目录。

样式层 skill：

https://github.com/soybeanjs/vean-ui/tree/main/skills/skills/vean-ui

Aria skill：

https://github.com/soybeanjs/vean-ui/tree/main/skills/skills/vean-aria

Claude Code

Claude Code 也可以直接从 GitHub 目录安装单个 skill：

claude skill add https://github.com/soybeanjs/vean-ui/tree/main/skills/skills/vean-ui
claude skill add https://github.com/soybeanjs/vean-ui/tree/main/skills/skills/vean-aria

发布出来的 skills 包中也包含 Claude marketplace 所需的元数据。

其它 AI 工具

任何支持 GitHub skill 目录或自定义说明目录的 AI 工具，都可以复用同一套来源。

实际建议

  1. 如果你同时会用样式层与 aria 包，优先安装完整的 @vean/skills。
  2. 需要组件用法、主题配置和文档导航时，使用 vean-ui。
  3. 需要组合模式或自定义样式包装方案时，使用 vean-aria。
  4. 当你需要文档全局上下文而不是技能包上下文时，再把 llms.txt 当作补充来源。

相关页面