在这里插入图片描述

面向读者:有一定实践经验的前端开发、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」,可以理解成三层含义:

  1. 一段结构化的 Markdown 文档,面向 Agent,而不是人类用户。
  2. 里面写的是某一类任务的使用说明、注意事项、推荐做法,比如「如何用 Vite 配置库模式」「如何在 Vue 中写测试」。
  3. 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:比如 vuenuxtpinia 等。
  • Description:简要说明这个技能覆盖的主题,如「Vue 核心:响应式、组件、组合式 API」等。
  • Source:对应的官方文档仓库,如 vuejs/docsvitejs/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」。

核心观点可以提炼为几条:

  1. Skills 的价值在于「可分享」「按需加载」。

    • 可分享:不同项目可以复用同一份技能,比如 vue-best-practices
    • 按需加载:只在需要时加载某个技能,避免把上下文塞满。
  2. AGENTS.md 的确在很多情况下「更好用」。

    • 它一次性加载所有内容,所以 Agent 几乎不会漏看某条规则。
    • 相比之下,Skills 有可能出现「本来该用的技能没被加载」的问题。
  3. 作者认为,这更多是工具层/集成层的问题。Skills 本质只是一个「Agent 消费的标准格式」,也就是一堆 Markdown 文件。

  4. 实际使用时,你完全可以这样搭配:

    • 把一些「必须遵守」的技能直接写进 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,可以这样搭配:

  • 基础技能:vuevitevitestvitepress
  • 工程实践:vue-best-practicesvue-router-best-practicesvue-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.jsonpnpm-workspace.yamltsconfig.json 等。

6.2 git submodule:保持与上游文档同步

在 README 的 FAQ 部分,作者提到一个关键点:这个项目的特别之处在于,它用 git submodule 直接引用源文档仓库。

这么做有几个好处:

  • 直接使用上游仓库内容作为「事实来源」,减少复制粘贴导致的偏差。
  • 随着上游文档演进,技能可以通过脚本自动更新,不用人工逐个改。
  • 不同项目维护自己的技能仓库时,也可以用同样的方式复用公共文档。

在企业里,这个设计的对应做法就是:把内部文档仓库当成「源」,通过类似的脚本生成 Agent 技能,而不是让人手动维护两套内容。

6.3 生成技能的完整流程

README 中的「Generate Your Own Skills」小节给出了一套推荐流程:

  1. Fork 或 clone 这个仓库。
  2. 安装依赖:pnpm install
  3. 修改 meta.ts,填上你自己的项目和技能来源。
  4. 运行 pnpm start cleanup,清空现有 submodule 和技能文件。
  5. 运行 pnpm start init,克隆新的 submodule。
  6. 运行 pnpm start sync,同步外部技能。
  7. 然后,让你的 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」:加载 vuevitevue-best-practicescompany-vue-conventions
  • 「测试助手 Agent」:加载 vitestvue-testing-best-practicescompany-testing
  • 「文档生成 Agent」:加载 vitepressweb-design-guidelines、公司内部文档规范技能。

这样,Agent 知识来源有三层:

  1. 公共开源生态(来自 antfu/skills 收集的开源技能)。
  2. 公司内部规范文档(通过脚本和 Agent 生成技能)。
  3. 团队/个人偏好(手工维护的技能)。

九、实操

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                │
  ├────────────────────────────┼──────────────────────────────────┤
  │ pnpmpnpm 包管理器                    │
  ├────────────────────────────┼──────────────────────────────────┤
  │ 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         │
  ├────────────────────────────┼───────────────────────────┤
  │ pnpmpnpm 包管理器             │
  ├────────────────────────────┼───────────────────────────┤
  │ 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 能真正用得上的技能库」里,这一步迈出去之后,后续的智能化改造就会顺畅很多。

在这里插入图片描述

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐