本篇目录
本文 2026 年 10 月整理。Skill 生态更新很快,命令和安装位置以各 Agent 的官方说明为准。
点点说:Skill 听起来很技术,其实就是一张「做事说明书」。先照着装一个、用一次,再写一个自己的,半小时就能上手。

Skill 是什么
你可以把 Skill 理解成交给 AI 的一张岗位说明书:遇到某类事情该怎么做、按什么格式交付、要避开哪些坑,都写在里面。
它的样子非常朴素,就是一个文件夹:
weekly-report/├── SKILL.md ← 必须有:名字、用途说明,加上做事步骤├── references/ ← 可选:比较长的参考资料├── assets/ ← 可选:模板、示例文件└── scripts/ ← 可选:AI 可以运行的小脚本其中 SKILL.md 开头有两行最重要:
- name:Skill 的名字,只能用小写英文字母、数字和连字符,最长 64 个字符
- description:这个 Skill 做什么、什么时候该用它,最长 1024 个字符
AI 平时只看这两行,等你的任务刚好对上,它才把整份说明书读进来照着做。

为什么最近这么火
- 一次写好,到处能用:Agent Skills 是一个开放格式,Claude Code、Codex、Cursor、GitHub Copilot、OpenCode 等都能读同一种
SKILL.md。Anthropic 在 10 月 22 日说,已有 70 多个 Agent 平台采用了这个标准 - 有了中立的「主人」:同一天,Anthropic 把这个标准捐给了 Linux 基金会旗下的 Agentic AI 基金会(AAIF),和 MCP、AGENTS.md 放在一起维护,不再由一家公司说了算
- 高手的做法可以直接拿来用:GitHub 上最热门的 Skill 仓库已经有 30 多万人收藏,开发流程、设计审美、写作去 AI 味、做小红书配图,都有人写好了
- 连 Gemini App 也在跟进:Google 从 10 月 13 日起,把 Gemini App 里的 Gems 逐步换成了「技能」
它和提示词、MCP 有什么不同
这三样经常被放在一起说,区别其实很清楚:
| 提示词 | Skill | MCP | |
|---|---|---|---|
| 像什么 | 当面交代一句话 | 一本可以反复翻的工作手册 | 一根连到外部系统的数据线 |
| 解决什么 | 这一次怎么做 | 这类事以后都这么做 | 让 AI 能读写别的软件和数据 |
| 存在哪里 | 聊天框里,用完就没了 | 文件夹里,长期有效 | 一个单独运行的服务 |
| 例子 | 「帮我把这段改短一点」 | 「我们公司周报的固定格式」 | 连上 GitHub、Notion、数据库 |
一句话记住:提示词管这一次,Skill 管这一类,MCP 管连到哪里。 三者经常一起用:Skill 里写好「先用 MCP 从 Notion 拉本周任务,再按模板写周报」。

它为什么不会把 AI 撑爆:按需翻开
你可能担心:装了几十个 Skill,AI 每次都要读一大堆说明书,岂不是又慢又费钱?
不会。Skill 是分三层、按需加载的:
1. 目录:开始时只读每个 Skill 的名字和用途说明,每个大约 100 个 token
2. 正文:判断任务对得上,才读完整的 SKILL.md。官方建议正文控制在 5000 个 token、500 行以内
3. 附件:步骤里用到参考资料、模板或脚本时,才去打开对应文件
所以 description 写得好不好,直接决定 AI 会不会在该用的时候想起它。

第一次安装:3 分钟装好一个 Skill
我们用 Archify 做例子。它能把一句话变成可以点击的交互图解,不需要 API Key,效果一眼就看得见。
第一步:准备好两样东西
- 一个支持 Skill 的 Agent,比如 Claude Code、Codex、Cursor。还没装?先看 第一次用 Claude Code
- Node.js 22.20 或更新版本。在终端输入
node -v查看版本号
第二步:一条命令安装
在终端里运行:
npx skills add tt-a1i/archify -gnpx skills 是一个通用的 Skill 安装工具,能识别你电脑上装了哪些 Agent。运行后会让你勾选装到哪几个 Agent 里;-g 表示所有项目都能用,不加就只装在当前文件夹的项目里。
第三步:确认装好了
- Claude Code:新开一个会话,输入
/搜 archify,或者直接问「你现在有哪些可用的 Skill?」 - Codex:先重启 Codex,再输入
$看能不能找到它
第四步:用起来
不用记命令,直接用平常的话说,提到 Skill 的名字能让它更快对上:
用 Archify 画一张「零基础学 AI 的 30 天路线图」,按周分成 4 段,每段标出要学的工具和要做的小作品。它会生成一个 HTML 文件,用浏览器打开就能点击、缩放。不满意就接着说:「第 3 周加上 Skill 入门」「换成浅色主题」。
以后怎么管理
npx skills list 看装了哪些npx skills check 检查有没有新版本npx skills update 更新npx skills remove 删除npx skills find 按关键词找新的 Skill自己写一个 Skill:让 AI 按你的格式写周报
装别人的 Skill 很方便,但最有价值的往往是把你自己的做法写下来。我们写一个周报 Skill:以后只要说「帮我写本周周报」,它就按你公司的格式来。
第一步:生成模板
npx skills init weekly-report会在当前文件夹里得到一个 weekly-report 文件夹,里面有一份 SKILL.md 模板。也可以手动建文件夹、新建这个文件。注意:文件夹名要和 name 一模一样。
第二步:把 SKILL.md 改成这样
---name: weekly-reportdescription: 按公司固定格式写工作周报。当用户提到周报、本周总结、工作汇报,或给出一周的任务清单让你整理时使用。---
# 周报写法
## 先收集材料1. 先问用户本周做了哪些事;如果给了任务清单或会议纪要,直接从里面整理2. 缺少数字(完成率、数据变化)时,留下「【待补充】」,不要自己编
## 固定格式一、本周完成(3~6 条,每条一句话,先写结果再写过程)二、关键数据(没有就写「本周无」)三、遇到的问题和需要的支持四、下周计划(3 条以内,写清截止日期)
## 写作要求- 每条不超过 40 个字,不用形容词堆砌- 不写「赋能」「抓手」「闭环」这类套话- 写完检查:有没有编造的数字、有没有漏掉用户给的事项第三步:放到 Agent 能找到的地方
npx skills init 会在你当前所在的文件夹里生成它。写好后,把整个文件夹放到你用的 Agent 能找到的位置:
- Claude Code:
~/.claude/skills/weekly-report/(所有项目都能用),或项目里的.claude/skills/weekly-report/ - Codex:
~/.agents/skills/weekly-report/,或项目里的.agents/skills/weekly-report/
其他 Agent 的位置,可以在 Skill 仓库的安装助手 里选对应的 Agent 查看。
第四步:试一次,再改一次
新开一个会话,说:
帮我写本周周报:周一改了官网首页,周三和客户开了需求会,周五上线了新版注册流程,注册转化率从 12% 到了 15%。如果它没有按你的格式写,多半是 description 不够清楚。把用户会怎么说(「周报」「本周总结」「工作汇报」)都写进 description,比把正文写得更长有用得多。
写好 Skill 的四个习惯
- description 写「做什么 + 什么时候用」,带上用户会说的关键词
- 正文写步骤和标准,不写大道理;能举一个输入、输出的例子最好
- 长资料放进 references/,在正文里写一句「需要时读 references/xxx.md」
- 固定格式放进 assets/,比如 Word 或 PPT 模板,让它照着填
装别人的 Skill 之前,先过这份安全清单
Skill 里可以带脚本,AI 会照着里面的话去做事。装之前花两分钟看一看:
- 看来源:优先装官方仓库和收藏多、维护活跃的仓库;同名的「搬运版」多留个心眼
- 看 SKILL.md:有没有让 AI 上传文件、读取密码、关闭安全检查之类的要求
- 看 scripts/:带脚本的 Skill,先大致看一下脚本做什么;看不懂就让 AI 先给你讲一遍,别急着运行
- 看许可证:打算商用的,看一眼 LICENSE
- 别贪多:只装真正用得上的。Skill 越多,AI 越容易用错,也会多读不少说明
- 关掉统计:
npx skills会收集匿名使用数据,不想上报可以设置环境变量DISABLE_TELEMETRY=1
去哪里找好用的 Skill
- 灵点AI Skill 仓库:我们精选的热门开源 Skill,每个都写了能得到什么、需要准备什么、装好后第一句怎么说,还有按 Agent 分的安装助手
- Anthropic 官方 Skills:做 Word、Excel、PPT、PDF 这类文档的 Skill,质量稳定
- 命令行里搜:
npx skills find 关键词
常见问题
装好了,但 AI 好像不用它?
先确认装对了位置(见上文「确认装好了」),再新开一个会话。还是不用,就在提问里点名,比如「用 weekly-report 写本周周报」。长期不触发,就回去改 description。
Skill 能在网页版 ChatGPT、Claude 里用吗?
各家支持程度不一样,入口也经常变。本文的方法针对 Claude Code、Codex、Cursor 这类在电脑上运行的 Agent,网页版请以各家官方说明为准。
一个 Skill 能同时给好几个 Agent 用吗?
可以,这正是开放标准的好处。用 npx skills add 安装时可以一次勾选多个 Agent;自己写的 Skill,复制到各个 Agent 的 skills 文件夹即可。
Skill 和插件是什么关系?
插件是一个「大礼包」,可以把 Skill、MCP、命令、钩子打包在一起安装。只想要一套做事方法,装 Skill 就够了。想了解 Claude Code 里各种扩展怎么选,看 扩展 Claude Code:MCP、Skill、子代理和钩子。
下一步
- 去 Skill 仓库 挑一个和你工作最相关的 Skill,装上用一周
- 把你最常重复的一件事(周报、会议纪要、选题、回复客户)写成自己的 Skill
- 想把资料变成学习材料,看下一篇:Gemini Notebook 学习法