别光盯着官方文档死磕 Skill 了

别光盯着官方文档死磕 Skill 了，去实战，干中学。

官方文档只会堆砌”加载机制”、“渐进式披露”这些概念，这就好比编程书只教语法——光背语法，永远学不会写代码。

学任何东西都要有目的，没有目的无法检验自己的学习成果，所以学习 Skill 的第一步是：给自己立个目标。

1. 定目标

这个目标优先选择可以为自己提效的东西，并且它不能太简单。

如果某个任务，你给 Claude Code 输入一句话就可以完成，那它没必要成为 Skill。

建议从你手边高频、重复、且繁琐的痛点入手，做一个能实实在在为你提效的自动化 Skill。

比如你在做自媒体：可以做个一键发文 Skill，把 Markdown 直接转成公众号富文本或 X 的富文本格式，甚至自动生成配图、渲染一级标题颜色，把排版时间从 30 分钟压缩到 3 秒。

比如你在做编程：那你可以做一个 Skill 专门用来检查你的所有代码格式、是否有低级 BUG、自动加上关键注释，自动去掉所有兼容性代码。

所有市面上已有公开的 Skill 你在使用的过程中都有必要做一些微调，因为只有自己知道什么样的结果才是自己想要的。

我相信每个人都有自己需要的 Skill，所以学习工具的第一件事应该是：为自己提效。

Skill 的官方文档洋洋洒洒写了一大堆，核心就两个概念：文件系统抽象和渐进式披露。

所谓文件系统抽象意思就是：Skill 整体被存放到本地文件夹中。

所谓渐进式披露的意思就是：它不会被一次性加载到 Agent 上下文中，而是在有需要的时候，自动加载整个 skill.md 文件。

在你不做大型项目的时候，这些东西都没什么用，写 Skill 就是为了用的，甚至很多人的用法就是手动触发 Skill。

当然，Skill 的基本结构你还是要懂，一个 Skill 就是一个文件夹，核心是 skill.md 文件，必须包含 YAML 头部（name, description）。

它和传统 Prompt 最大的不同是，它能够在这个文件夹里携带一些额外资源，一般就是脚本代码和参考资料，示例结构如下：

pdf-skill/
├── skill.md          (主要指令)
├── form-guide.md     (表单填充指南)
├── api-reference.md  (详细 API 参考)
└── scripts/
    └── fill_form.py  (实用脚本)

Skill 更像是教 Claude 如何工作，skill.md 是完整的说明书，而 scripts 文件夹则是工具箱，存放需要用到的 Python 脚本。

api-reference.md 则可以放一些更详细的说明书，你可以直接在 skill.md 中说明在某场景下调用 scripts 文件夹下的 fill_form.py 脚本让 Claude 执行。

scripts 有什么用？你用到的所有第三方的东西都可以通过 Python 脚本程序来运行。

比如，你现在要给自己的文章自动配图，那你需要接入一个第三方生图模型的 API、比如豆包或者 Gemini-Image，这些都可以直接放在 Python 程序里。

那么你的 Skill 就可以直接写明使用对应的程序进行生图，Claude Code 就能自动调用你这个 Python 程序运行，然后生成图片。

你不需要懂 Python 语法，只需要懂提需求，描述清楚你要干什么，剩下的代码编写、API 调用，统统交给 Claude Code。

我们的目的始终是完成某项目标，而不是学会技术细节。

当你立好目标，了解完概念之后，就可以直接开干了。

先把自己的目标和 Claude Code 进行沟通，让它先给你做一个最基础的 Skill。

它会给你生成 Skill 配套的目录结构和程序脚本，你可以随便打开一个文本编辑器如 VS Code 去看它在 skill.md 中写了什么。

如果不符合你的需求，你可以继续和 Claude Code 沟通，或者自己亲自去改这个文件，之前我已经说过了，skill.md 就是一份程序运行指南，这里面描述了你要做的所有事和做事的流程。

接着，你可以直接告诉 Claude Code，运行名字为 xxx 的 Skill。

观察它的运行情况和输出结果，不符合要求就让 AI 继续改，然后接着验证，直到满足自己的需求。

做任何 Skill 前，先和 Claude Code 沟通，注意能力边界，看这个需求能不能实现。

比如做行业研报 Skill，第一步是联网搜索，如果你没有 Claude Code 付费账号（付费才能使用搜索），不要强行让 AI 无中生有，要么手动投喂 PDF，要么申请第三方搜索 API（如 Serper），让 Skill 调用。

如果你想要学习某个 Skill，可以直接用 Claude Code 下载那个 Skill，让它给你讲解，或者你在上面添加一些自己想要的功能。

Skill 被下载之后就会留存在自己的本地，变成了一个文件夹和一堆文件，你可以自己随意修改。

推上也有很多推友自己写好的 Skill，你只需要复制链接，然后告诉 Claude Code 帮我下载即可。

网上还有一个汇聚了 5W+ Skill 的网站：Skillsmp，写之前也可以去这里找找有没有别人写好的工具。

记住，下载任何第三方的 Skill 之后，别急着运行，先让 Claude Code 进行一遍安全检查，看看是否有什么可疑的攻击性文件。

Skill 结构示例