Vibe Coding - 从文档到技能:拆解 antfu/skills 这套 Agent 知识库工程
《Agent技能库工程实践:结构化知识与自动化开发》摘要 本文解析了antfu/skills项目如何将技术文档与个人经验结构化,构建Agent可用的技能库系统。该项目通过三层架构实现知识管理:手工维护的个人经验包、从官方文档生成的系统知识模块,以及通过git submodule同步的外部项目技能。核心创新在于采用Markdown+自动化脚本的工程方案,将分散文档转化为Agent可理解的"
文章目录

面向读者:有一定实践经验的前端开发、AI 应用开发者、Agent 系统构建者,希望把「文档 + 经验」结构化成 Agent 可用的技能库,用于自动化开发、代码助理或企业内部知识库。
一、这到底是个什么工程?
先说结论:antfu/skills 是 Anthony Fu 做的一套「Agent 技能合集模板」,核心目标有两点:
- 把自己在 Vue / Vite / Nuxt 等技术栈里的经验,沉淀成一份份细颗粒度的「技能」。
- 提供一套从「官方文档 + 外部项目」自动生成、同步技能的工程方案,方便你 Fork 之后改造成自己的技能库。
换句话说,你可以把它理解成:
「用 git submodule + 脚本 + Markdown,把一堆分散的文档和最佳实践,包装成 Agent 随取随用的技能包。」

这个仓库本身还是一个概念验证项目,作者也明确说:实际效果还没有被大规模验证,很欢迎反馈和 PR。
二、关键概念:什么是 Agent Skills?
仓库首页的介绍很简单:
「A curated collection of Agent Skills reflecting Anthony Fu’s preferences, experience, and best practices, along with usage documentation for the tools.」
这里的「Skill」,可以理解成三层含义:
- 一段结构化的 Markdown 文档,面向 Agent,而不是人类用户。
- 里面写的是某一类任务的使用说明、注意事项、推荐做法,比如「如何用 Vite 配置库模式」「如何在 Vue 中写测试」。
- Agent 在需要的时候,把对应 Skill 加载进上下文里,当成“专业手册”。
结合仓库里的说明,可以把 Skills 看成:
「给 Agent 用的主题化知识页」,既能跨项目复用,又比一次性塞进 AGENTS.md 更灵活。
三、Skills 的完整生态:从手工到自动生成
仓库中对技能做了一个很清晰的分层:
3.1 手工维护的技能:个人经验打包
章节:Hand-maintained Skills。
目前只有一个 antfu 技能,内容是 Anthony 自己常用的一整套工程习惯,比如:eslint、pnpm、Vitest、Vue 项目结构等。
- 性质:强个人风格、强主观偏好,适合你认同他的实践方式时直接复用。
- 角色:可以当成「项目脚手架 + 日常习惯」的一份说明书,给 Agent 用来对齐“这项目应该怎么写”。
这类技能的启发是:你完全可以为公司、团队或者某条业务线,写一份类似的「本地规范」,让 Agent 在参与项目时遵守同一套约定。
3.2 从官方文档生成的技能:系统知识抽取
章节:Skills Generated from Official Documentation。
这一块覆盖的是 Vue / Nuxt / Pinia / Vite / VitePress / Vitest / UnoCSS / pnpm 等一整套生态。
表格里有三列:
- Skill:比如
vue、nuxt、pinia等。 - Description:简要说明这个技能覆盖的主题,如「Vue 核心:响应式、组件、组合式 API」等。
- Source:对应的官方文档仓库,如
vuejs/docs、vitejs/vite等。
特点:
- 内容来源于官方文档,再经过作者适度调整,比如更偏向 TypeScript、ESM、组合式 API 等现代栈。
- 相当于给 Agent 做了一份「有重点的官方文档提炼版」,也方便和作者的工程实践统一口径。
这类技能的意义在于:把原本很长的多语言文档,变成 Agent 易于加载和理解的“主题模块”,比如「只加载测试相关技能」「只加载构建相关技能」。
3.3 Vendored Skills:外部项目自带技能的统一入口
章节:Vendored Skills。
这部分是通过 git submodule 从外部仓库同步来的“官方技能”,例如:
slidev:开发者演示文稿工具。tsdown:基于 Rolldown 的 TypeScript 打包工具。turborepo:单仓多包构建系统。vueuse-functions:VueUse 提供的 200+ 组合式函数。- 一系列 Vue 3 + TypeScript 最佳实践 / 路由最佳实践 / 测试最佳实践 等。
web-design-guidelines:Web 界面设计的基本规范。
这些技能的特点:
- 由各自项目维护者管理内容,
antfu/skills作为一个「聚合层」。 - 通过脚本定期从 submodule 同步更新,避免内容老化。
如果你要给公司做一个「统一 Agent 技能入口」,这一层的设计非常值得借鉴:既不抢项目官方的控制权,又可以统一加载和发布入口。
四、为什么不用一个 AGENTS.md 一把梭?
README 里单独有一节讨论了「Skills vs llms.txt vs AGENTS.md」。
核心观点可以提炼为几条:
-
Skills 的价值在于「可分享」「按需加载」。
- 可分享:不同项目可以复用同一份技能,比如
vue-best-practices。 - 按需加载:只在需要时加载某个技能,避免把上下文塞满。
- 可分享:不同项目可以复用同一份技能,比如
-
AGENTS.md 的确在很多情况下「更好用」。
- 它一次性加载所有内容,所以 Agent 几乎不会漏看某条规则。
- 相比之下,Skills 有可能出现「本来该用的技能没被加载」的问题。
-
作者认为,这更多是工具层/集成层的问题。Skills 本质只是一个「Agent 消费的标准格式」,也就是一堆 Markdown 文件。
-
实际使用时,你完全可以这样搭配:
- 把一些「必须遵守」的技能直接写进 AGENTS.md。
- 其余的做成技能集,让 Agent 根据任务需要动态加载。
如果你在为企业设计多 Agent 系统,一个比较合理的做法就是:
- AGENTS.md 存「组织级原则 + 高优先级规范」。
- Skills 存「具体技术、项目、模块的知识」,按场景加载。
antfu/skills 相当于给出了 Skills 这一层的工程模板。
五、安装与基础使用:如何在本地或环境中接入
5.1 安装技能集
README 提供了一个标准安装命令:
pnpx skills add antfu/skills --skill='*'
这个命令的含义是:通过 vercel-labs/skills 提供的 CLI,把 antfu/skills 仓库里的技能全部安装进当前环境。
如果想全局安装,则多加一个 -g 参数:
pnpx skills add antfu/skills --skill='*' -g
更多 CLI 用法需要查看上游 skills 项目的文档。
在一个真实系统里,你通常会做几件事:
- 在 Agent 框架/应用里封装一层「技能加载器」,底层调用这个 CLI 或对应 API。
- 针对不同任务类型(前端开发、测试、文档、性能优化),加载不同的技能组合。
- 在 Agent 的系统 prompt 中,明确「现在已加载哪些技能」,指导回复风格。
5.2 结合前端栈的实际使用思路
假设你在做一个「前端开发助手」,技术栈是 Vue 3 + Vite + VitePress + Vitest,可以这样搭配:
- 基础技能:
vue、vite、vitest、vitepress。 - 工程实践:
vue-best-practices、vue-router-best-practices、vue-testing-best-practices。 - UI 规范:
web-design-guidelines。 - 公共函数:
vueuse-functions。 - 团队特定习惯:Fork 后新增一个
company-web-app技能,写清楚目录结构、命名规范、常用依赖、接口风格等。
这样,Agent 每次在项目里写代码、改 Bug 或补文档时,等于随身带着几本「内置手册」。
六、工程实现:如何从文档自动生成技能
antfu/skills 不只是个技能合集,它还提供了从「源文档」到「技能文件」的一整套工程流程。
6.1 目录结构一眼看
从仓库根目录可以看到这些关键目录和文件:
skills/:最终给 Agent 使用的技能文件目录。sources/:技能来源配置,指向官方文档仓库等。vendor/:引入的外部技能仓库(git submodule)。scripts/:自动化脚本,比如同步 submodule、更新技能等。meta.ts:元信息配置文件,定义有哪些项目、技能、来源。
再加上基础工程文件:package.json、pnpm-workspace.yaml、tsconfig.json 等。
6.2 git submodule:保持与上游文档同步
在 README 的 FAQ 部分,作者提到一个关键点:这个项目的特别之处在于,它用 git submodule 直接引用源文档仓库。
这么做有几个好处:
- 直接使用上游仓库内容作为「事实来源」,减少复制粘贴导致的偏差。
- 随着上游文档演进,技能可以通过脚本自动更新,不用人工逐个改。
- 不同项目维护自己的技能仓库时,也可以用同样的方式复用公共文档。
在企业里,这个设计的对应做法就是:把内部文档仓库当成「源」,通过类似的脚本生成 Agent 技能,而不是让人手动维护两套内容。
6.3 生成技能的完整流程
README 中的「Generate Your Own Skills」小节给出了一套推荐流程:
- Fork 或 clone 这个仓库。
- 安装依赖:
pnpm install。 - 修改
meta.ts,填上你自己的项目和技能来源。 - 运行
pnpm start cleanup,清空现有 submodule 和技能文件。 - 运行
pnpm start init,克隆新的 submodule。 - 运行
pnpm start sync,同步外部技能。 - 然后,让你的 Agent 按项目逐个「生成技能」。
这里有两个很重要的实践点:
- 作者建议「一个项目一次生成」,避免一次性生成所有技能,既方便控制成本,也有利于质量检查。
- 技能生成过程本身,可以由 Agent 来完成——你提供源文档和 meta 配置,Agent 负责写出规范的技能 Markdown。
在公司落地时,这可以演化成一条流水线:
- 触发条件:某个项目文档更新 / 版本发布。
- 流程:拉取最新文档 → Agent 生成/更新技能文件 → 人工抽样审核 → 发布到统一技能仓库。
- 消费:各业务线的 Agent 按需引用这些技能。
七、Skills 与企业级知识库建设的关联
虽然 antfu/skills 面向的是开源前端生态,但里面的设计思路,很适合迁移到企业环境中。
7.1 把文档当“源”,把技能当“接口”
在企业里,你通常会有:
- 内部 Wiki、设计文档、架构说明。
- 接口平台文档、错误码说明。
- 各种开发规范、测试规范、安全规范。
如果直接拿这些内容喂给 Agent,问题很多:
- 文档太长,超出上下文。
- 格式不统一,有的偏讨论,有的偏记录。
- 不够结构化,Agent 很难稳定引用。
antfu/skills 的做法可以照搬:
- 文档仓库 = 源。
- Agent 生成的技能 Markdown = 面向 Agent 的「接口文档」。
- Skill 命名按主题划分,比如「支付风控规范」「用户隐私处理流程」。
这样,你等于建立了一层中间件:上游文档可以随便写,人看着舒服;下游技能是标准化格式,Agent 看着舒服。
7.2 Skills 与 AGENTS.md 的搭配使用
在 README 的 FAQ 里,有一句很关键的话:
Skills are really just a standardized format for agents to consume — plain markdown files at the end of the day. Think of them as a knowledge base for agents. If you want certain skills to always apply, you can reference them directly in your AGENTS.md.
翻译成企业语境:
- Skills = 结构化知识库条目。
- AGENTS.md = 这类 Agent 的「角色说明书 + 常驻规则集合」。
你可以:
- 在 AGENTS.md 中引用某些技能的路径,保证它们永远生效,比如合规要求、安全规范。
- 对于业务细节(某条业务线、某个系统),则通过「按需加载」的方式引入技能,避免所有 Agent 都被迫学习无关内容。
八、实战示例:如果我要做一个「前端项目 Agent 套件」
假设你是公司里的前端基础设施负责人,希望做一套「前端项目 Agent 套件」,服务对象是所有 Vue 3 / Vite 项目。
你可以用 antfu/skills 的思路,搭出这样一套方案:
8.1 技能规划
先定义技能模块(示例):
company-vue-conventions:公司内部 Vue 组件命名规范、目录结构、代码风格。company-api-guidelines:接口调用约定、错误码、重试策略。company-testing:单测、端测、Mock 数据使用说明。vue/vite/vitest/vue-best-practices等:直接复用开源技能。
8.2 工程结构
Fork antfu/skills 后,做这些改动:
- 在
meta.ts里加入公司 repo 的文档地址,比如「前端规范仓库」「接口平台文档仓库」。 - 在
sources/中为这些仓库配置对应的源。 - 通过脚本(参考
scripts/)拉取为 git submodule。
然后,写一套自己的生成指令,类似:
「阅读某某路径下的 Markdown,将其中与 Vue 组件组织相关的部分,整理成一份技能文档,命名为
company-vue-conventions。」
生成出来的技能文件统一放在 skills/ 目录,按模块命名。
8.3 Agent 使用策略
不同类型的 Agent,可以有不同的技能组合:
- 「开发助手 Agent」:加载
vue、vite、vue-best-practices、company-vue-conventions。 - 「测试助手 Agent」:加载
vitest、vue-testing-best-practices、company-testing。 - 「文档生成 Agent」:加载
vitepress、web-design-guidelines、公司内部文档规范技能。
这样,Agent 知识来源有三层:
- 公共开源生态(来自
antfu/skills收集的开源技能)。 - 公司内部规范文档(通过脚本和 Agent 生成技能)。
- 团队/个人偏好(手工维护的技能)。
九、实操
Claude Codex 中安装
Welcome to Opus 4.5
❯ /plugin
⎿ (no content)
❯ 帮我安装这个skill 地址 https://github.com/antfu/skills
⏺ 我来帮你安装这个 skill。首先让我获取这个仓库的信息。
⏺ Fetch(https://github.com/antfu/skills)
⎿ Received 313.3KB (200 OK)
⎿ Running PostToolUse hooks… (1/2 done)
⏺ 根据仓库信息,安装这个 skill 集合的命令是:
⏺ Bash(pnpx skills add antfu/skills --skill='*')
⎿ Error: Exit code 127
(eval):1: command not found: pnpx
⏺ 系统没有安装 pnpx。让我尝试使用 npx:
⏺ Bash(npx skills add antfu/skills --skill='*')
⎿ ███████╗██╗ ██╗██╗██╗ ██╗ ███████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝
███████╗█████╔╝ ██║██║ ██║ ███████╗
… +22 lines (ctrl+o to expand)
⎿ Running PostToolUse hooks… (1/2 done)
⏺ 命令执行后进入了交互模式需要选择 skill。让我使用 -y 标志来自动确认安装所有 skills:
⏺ Bash(npx skills add antfu/skills --skill='*' -y)
⎿ ███████╗██╗ ██╗██╗██╗ ██╗ ███████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝
███████╗█████╔╝ ██║██║ ██║ ███████╗
… +162 lines (ctrl+o to expand)
⎿ Running PostToolUse hooks… (1/2 done)
⏺ 安装成功!已安装 17 个 skills 到当前项目,包括:
┌────────────────────────────┬──────────────────────────────────┐
│ Skill │ 说明 │
├────────────────────────────┼──────────────────────────────────┤
│ antfu │ Anthony Fu 的应用/库项目最佳实践 │
├────────────────────────────┼──────────────────────────────────┤
│ vue │ Vue 官方文档 │
├────────────────────────────┼──────────────────────────────────┤
│ nuxt │ Nuxt 框架文档 │
├────────────────────────────┼──────────────────────────────────┤
│ pinia │ Pinia 状态管理 │
├────────────────────────────┼──────────────────────────────────┤
│ vite │ Vite 构建工具 │
├────────────────────────────┼──────────────────────────────────┤
│ vitepress │ VitePress 文档生成器 │
├────────────────────────────┼──────────────────────────────────┤
│ vitest │ Vitest 测试框架 │
├────────────────────────────┼──────────────────────────────────┤
│ unocss │ UnoCSS 原子化 CSS │
├────────────────────────────┼──────────────────────────────────┤
│ pnpm │ pnpm 包管理器 │
├────────────────────────────┼──────────────────────────────────┤
│ slidev │ Slidev 演示文稿 │
├────────────────────────────┼──────────────────────────────────┤
│ tsdown │ tsdown 打包工具 │
├────────────────────────────┼──────────────────────────────────┤
│ turborepo │ Turborepo monorepo 工具 │
├────────────────────────────┼──────────────────────────────────┤
│ vueuse-functions │ VueUse 组合式函数 │
├────────────────────────────┼──────────────────────────────────┤
│ vue-best-practices │ Vue 最佳实践 │
├────────────────────────────┼──────────────────────────────────┤
│ vue-router-best-practices │ Vue Router 最佳实践 │
├────────────────────────────┼──────────────────────────────────┤
│ vue-testing-best-practices │ Vue 测试最佳实践 │
├────────────────────────────┼──────────────────────────────────┤
│ web-design-guidelines │ Web 设计指南 │
└────────────────────────────┴──────────────────────────────────┘
Skills 已安装到 ./.agents/skills/ 目录,并已为 Claude Code 配置好符号链接。这些 skills 对你的 Vue 2 前端项目会很有帮助。
✻ Churned for 1m 35s
❯ 这个vue的skills是全局生效 还是仅限于当前项目?
⏺ 根据安装输出显示,这些 skills 是仅限于当前项目生效的。
从输出可以看到:
Installing to: ./.agents/skills/antfu
Installing to: ./.agents/skills/vue
...
所有 skills 都安装到了当前项目的 ./.agents/skills/ 目录下,而不是全局目录。
如果你想全局安装(对所有项目生效),需要添加 -g 标志:
npx skills add antfu/skills --skill='*' -y -g
全局安装后,skills 会安装到你的 home 目录下的配置位置(如 ~/.config/ 或类似路径),这样任何项目都可以使用这些 skills。
需要我帮你全局安装一份吗?
❯ 好的,全局安装一份
⏺ Bash(npx skills add antfu/skills --skill='*' -y -g)
⎿ ███████╗██╗ ██╗██╗██╗ ██╗ ███████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝
███████╗█████╔╝ ██║██║ ██║ ███████╗
… +178 lines (ctrl+o to expand)
⎿ Running PostToolUse hooks… (1/2 done)
⏺ 全局安装完成。17 个 skills 现在已安装到 ~/.agents/skills/ 目录,所有项目都可以使用这些 skills 了。
✻ Worked for 42s
❯ 类一下有哪些skill
⏺ Bash(npx skills list)
⎿ Project Skills
antfu ./.agents/skills/antfu
… +33 lines (ctrl+o to expand)
⎿ Running PostToolUse hooks… (1/2 done)
⏺ 已安装的 Skills 列表:
┌────────────────────────────┬───────────────────────────┐
│ Skill 名称 │ 说明 │
├────────────────────────────┼───────────────────────────┤
│ antfu │ Anthony Fu 的项目最佳实践 │
├────────────────────────────┼───────────────────────────┤
│ vue │ Vue 官方文档 │
├────────────────────────────┼───────────────────────────┤
│ nuxt │ Nuxt 框架 │
├────────────────────────────┼───────────────────────────┤
│ pinia │ Pinia 状态管理 │
├────────────────────────────┼───────────────────────────┤
│ vite │ Vite 构建工具 │
├────────────────────────────┼───────────────────────────┤
│ vitepress │ VitePress 文档生成器 │
├────────────────────────────┼───────────────────────────┤
│ vitest │ Vitest 测试框架 │
├────────────────────────────┼───────────────────────────┤
│ unocss │ UnoCSS 原子化 CSS │
├────────────────────────────┼───────────────────────────┤
│ pnpm │ pnpm 包管理器 │
├────────────────────────────┼───────────────────────────┤
│ slidev │ Slidev 演示文稿工具 │
├────────────────────────────┼───────────────────────────┤
│ tsdown │ tsdown 打包工具 │
├────────────────────────────┼───────────────────────────┤
│ turborepo │ Turborepo monorepo 管理 │
├────────────────────────────┼───────────────────────────┤
│ vueuse-functions │ VueUse 组合式函数库 │
├────────────────────────────┼───────────────────────────┤
│ vue-best-practices │ Vue 最佳实践 │
├────────────────────────────┼───────────────────────────┤
│ vue-router-best-practices │ Vue Router 最佳实践 │
├────────────────────────────┼───────────────────────────┤
│ vue-testing-best-practices │ Vue 测试最佳实践 │
├────────────────────────────┼───────────────────────────┤
│ web-design-guidelines │ Web 设计指南 │
└────────────────────────────┴───────────────────────────┘
所有 17 个 skills 都支持 Claude Code、Cursor、Codex 等多种 AI 编程工具。
codex 中安装
› 帮我安装这个skill 地址 https://github.com/antfu/skills
• 我会按 skill-installer 的流程来安装这个 GitHub skill,先读取它的 SKILL.md 确认标准安装步骤,然后直接帮你执行安装。
• Explored
└ Read SKILL.md
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
• 我已经拿到安装规范,下一步先确认安装脚本支持 GitHub 仓库根地址 的方式,再按最稳妥参数执行,避免装错目录。
• Explored
└ Read install-skill-from-github.py
List scripts
Read install-skill-from-github.py
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
• 安装脚本必须指定仓库内具体 skill 路径。我先快速读取这个仓库的目录结构,定位包含 SKILL.md 的路径后再执行安装。
• Called fetch.fetch({"url":"https://api.github.com/repos/antfu/skills/contents","max_length":20000})
└ Content type application/json; charset=utf-8 cannot be simplified to markdown, but here is the raw content:
Contents of https://api.github.com/repos/antfu/skills/contents:
[{"name":".github","path":".github","sha":"03072e0f7ef37d39c8ab46e98aac097c8516cf54","size":0,"url":"https://api.github.com/repos/antfu/skills/contents/.github?ref=main","html_url":"https://github.com/
antfu/skills/tree/main/.github","git_url":"https://api.github.com/repos/antfu/skills/git/trees/03072e0f7ef37d39c8ab46e98aac097c8516cf54","download_url":null,"type":"dir","_links":{"self":"https://
api.github.com/repos/antfu/skills/contents/.github?ref=main","git":"https://api.github.com/repos/antfu/skills/git/trees/03072e0f7ef37d39c8ab46e98aac097c8516cf54","html":"https://github.com/antfu/
skills/tree/main/.github"}},{"name":".gitignore","path":".gitignore","sha":"95f9ee9e2890090d2da31795404ec315847f6e5a","size":80,"url":"https://api.github.com/repos/antfu/skills/contents/.gitignore?
ref=main","html_url":"https://github.com/antfu/skills/bl...
• Called fetch.fetch({"url":"https://api.github.com/repos/antfu/skills/contents/skills?ref=main","max_length":20000})
└ Content type application/json; charset=utf-8 cannot be simplified to markdown, but here is the raw content:
Contents of https://api.github.com/repos/antfu/skills/contents/skills?ref=main:
[{"name":"antfu","path":"skills/antfu","sha":"892f71a5d96f9ad720d7af4cdb692852b643f119","size":0,"url":"https://api.github.com/repos/antfu/skills/contents/skills/antfu?ref=main","html_url":"https://
github.com/antfu/skills/tree/main/skills/antfu","git_url":"https://api.github.com/repos/antfu/skills/git/trees/892f71a5d96f9ad720d7af4cdb692852b643f119","download_url":null,"type":"dir","_links":
{"self":"https://api.github.com/repos/antfu/skills/contents/skills/antfu?ref=main","git":"https://api.github.com/repos/antfu/skills/git/trees/892f71a5d96f9ad720d7af4cdb692852b643f119","html":"https://
github.com/antfu/skills/tree/main/skills/antfu"}},{"name":"nuxt","path":"skills/nuxt","sha":"a83cf8de14f79487619c7938847a0070726225da","size":0,"url":"https://api.github.com/repos/antfu/skills/
contents/skills/nuxt?ref=main","html_url":"...
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
• 这个仓库里是一个技能集合,不是单一目录。我先看它的 README 推荐安装方式,按作者建议给你装。
• Called fetch.fetch({"url":"https://raw.githubusercontent.com/antfu/skills/main/README.md","max_length":20000})
└ Content type text/plain; charset=utf-8 cannot be simplified to markdown, but here is the raw content:
Contents of https://raw.githubusercontent.com/antfu/skills/main/README.md:
# Anthony Fu's Skills
A curated collection of [Agent Skills](https://agentskills.io/home) reflecting [Anthony Fu](https://github.com/antfu)'s preferences, experience, and best practices, along with usage documentation for the
tools.
> [!IMPORTANT]
> This is a proof-of-concept project for generating agent skills from source documentation and keeping them in sync.
> I haven't fully tested how well the skills perform in practice, so feedback and contributions are greatly welcome.
## Installation
```bash
pnpx skills add antfu/skills --skill='*'
```
or to install all of them globally:
```bash
pnpx skills add antfu/skills --skill='*' -g
```
Learn more about the CLI usage at [skills](https://github.com/vercel-labs/skills).
## Skills
This collection is aim to be a one-stop collection of you are mainly working on Vite/Nuxt. It i...
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
• README 推荐是安装整套 skill 集合(*)。我会按这个语义一次装全,并先检查本地是否已有同名目录避免冲突。
✔ You approved codex to always run commands that start with python3 /Users/artisan/.codex/skills/.system/skill-installer/scripts/install-...
• Explored
└ List skills
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
• 安装已完成,我再快速核对本地目录,确认这些 skill 都落盘到了 ~/.codex/skills。
• Explored
└ List skills
Search SKILL.md in skills
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
• 已按 skill-installer 把 https://github.com/antfu/skills 的整套 skills 安装到 ~/.codex/skills,共 17 个:
antfu, nuxt, pinia, pnpm, slidev, tsdown, turborepo, unocss, vite, vitepress, vitest, vue, vue-best-practices, vue-router-best-practices, vue-testing-best-practices, vueuse-functions, web-design-guidelines。
Restart Codex to pick up new skills.
› 这个vue的skills是全局生效 还是仅限于当前项目?
• 是全局可用。
你这次装在 ~/.codex/skills/vue,所以同一台机器、同一账号下的所有项目都能用。
但它不是“每次都自动生效”:是否在当前对话里启用,取决于触发规则(比如你显式提到该 skill,或项目 AGENTS.md 要求使用)。如果刚装完,重启 Codex 后才会被识别。
› 列一下有哪些skill
• 我直接读取你本机 ~/.codex/skills 目录,给你列出当前可见的 skill 列表。
• Explored
└ List skills
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
• 当前有这些 skill:
1. .system(系统内置)
2. antfu
3. nuxt
4. pinia
5. pnpm
6. slidev
7. tsdown
8. turborepo
9. unocss
10. vite
11. vitepress
12. vitest
13. vue
14. vue-best-practices
15. vue-router-best-practices
16. vue-testing-best-practices
17. vueuse-functions
18. web-design-guidelines
十、写在最后:这套工程给我们的启发
回过头看,antfu/skills 其实在做一件非常具体的事:
在「人类写给人类的文档」和「Agent 需要的结构化知识」之间,搭了一层自动化桥梁。
这层桥梁的关键要素有:
- 用 git submodule 连接上游文档,保证来源一致且易于更新。
- 用 meta 配置和脚本,标准化「从文档到技能」的过程。
- 用 Skill 的形式,把知识模块化、可分享、可按需加载。
- 通过 AGENTS.md 与技能搭配,既保留一部分「全局规则」,又支持任务级定制。
如果你在做 Agent 系统、企业知识库、大模型应用平台,这个仓库更像是一份「工程蓝本」:
- 不一定要照搬所有实现细节,但可以整体借用:
- 目录结构
- 技能来源分类
- 同步机制
- 生成流程设计
真正的价值不在于「复刻一个 antfu/skills」,而在于:
你可以用类似的方式,把团队和公司的知识,慢慢从「文档堆」搬到「Agent 能真正用得上的技能库」里,这一步迈出去之后,后续的智能化改造就会顺畅很多。

更多推荐


所有评论(0)