Skills 不是 Markdown 文件，是技能包
很多人对 Skills 的理解停留在「写一段 Markdown 提示词」，这是一个关键误区。
Skills 的本质是「指令 + 脚本 + 资源 + 工具配置」的模块化单元。每个 Skill 是一个文件夹，入口是 SKILL.md，里面用 YAML 配置声明触发条件和使用方式。文件夹中还可以放脚本、数据模板、配置文件，Claude 会在需要时自动读取和调用。
Skills 遵循 Agent Skills 开放标准，不只 Claude Code 能用，Claude Desktop 同样支持。
两种使用方式并存：一是自动触发——你正常对话，Claude 检测到相关 Skill 后主动加载；二是手动调用——输入 /skill-name，像斜杠命令一样精确触发。Claude Code 本身已经内置了几个 Skill：/batch 把大规模代码修改拆成并行子任务，/simplify 审查代码找出优化点，/debug 排查当前会话问题，/loop 定时循环执行操作。
用一个类比来理解：没有 Skills，Claude「会做」PPT，但产出粗糙；有了 Skills，Claude「做得专业」，因为 Skills 里封装了经过反复验证的最佳实践。
Anthropic 内部的 9 大 Skills 类型
Anthropic 团队对内部数百个 Skills 做了归类，聚集在 9 个方向上。这个分类本身就是一份很好的选题清单：
- 库与 API 参考类——教 Claude 正确使用某个库或 SDK，把常见坑和正确用法打包进去，特别适合那些 Claude 容易搞错的库
- 产品验证类——搭配 Playwright 等工具自动跑测试流程，比如「注册→验证邮箱→引导流程」的全链路测试。Anthropic 原话是「值得让一个工程师花一整周专门打磨验证类 Skills」，可见权重之高
- 数据获取与分析类——连接数据系统，告诉 Claude 去哪查数据、怎么查、常用查询模式是什么
- 业务流程自动化类——一条命令搞定重复性工作，比如自动聚合 GitHub 活动和工单系统，生成站会汇报
- 代码脚手架类——自动生成项目模板，新建一个服务时认证、日志、部署配置全部预配好
- 代码质量与审查类——自动代码审查，最狠的是 adversarial-review，生成一个全新视角的子 Agent 来挑刺，反复迭代到只剩无关痛痒的小问题
- CI/CD 与部署类——监控 PR、重试不稳定的 CI、解决合并冲突、自动回滚，全自动
- 运维手册类——给一个告警或错误，自动走排查流程，输出结构化报告
- 基础设施运维类——清理孤立资源、管理依赖审批、排查费用飙升原因
对于一人公司场景，第 2、4、5、6 类的价值最直接——产品验证、流程自动化、项目脚手架和代码审查，恰好是独立开发者最缺人手的环节。
写好 Skills 的 6 个关键原则
知道类型只是第一步，怎么写出高质量的 Skills 才是核心。以下是 Anthropic 团队从实战中提炼的方法：
原则一：不写废话，只写「反直觉」的信息。 Claude 本身编程能力很强，你的 Skill 应该聚焦在那些能把它从常规思维中「推出来」的东西。比如官方的 frontend-design Skill，专门教 Claude 避免「Inter 字体 + 紫色渐变」这类 AI 味儿太重的设计倾向。
原则二：Gotchas 章节是灵魂。 每次 Claude 犯错，就把那个错误记到 Skill 的 Gotchas 部分。日积月累，这个章节会成为整个 Skill 中信息密度最高的区域，也是让 Skill 越用越稳的关键机制。
原则三：善用文件夹做渐进式信息披露。 别把所有内容塞进一个 Markdown 文件。把详细的 API 签名放到 references/api.md，模板放到 assets/ 目录，Claude 会在需要时自己去读。本质上是把文件系统当作上下文工程的手段。
原则四：给信息和灵活度，别给死板步骤。 Skills 的复用性很强，如果指令太具体，Claude 在不同场景下会变得僵硬。
原则五：Description 是触发器，不是摘要。 Claude Code 启动时会扫描所有 Skills 的 description 来判断「这个请求该不该调用这个 Skill」。所以 description 应该写「什么时候触发」，而不是「这个 Skill 是什么」。另外，SKILL.md 的 frontmatter 有几个实用配置值得注意：
disable-model-invocation: true——禁止 Claude 自动调用，只能手动/skill-name触发，部署、发布这类有副作用的操作建议必开allowed-tools——限制 Skill 运行时能用的工具，比如只读分析的 Skill 只给 Read、Grep 权限context: fork——在独立的子 Agent 中运行，不污染主对话上下文
原则六：让 Skills 拥有记忆。 在 Skill 目录中存储数据，Claude 就能读取自己的历史输出。比如一个生成站会汇报的 Skill 可以维护一个 standups.log，下次运行时自动对比昨天的记录，只汇报变化部分。
Skills 的分发与管理
Skills 有三层存储结构：
| 层级 | 路径 | 作用范围 |
|---|---|---|
| 个人 | ~/.claude/skills/ |
你所有项目都能用 |
| 项目 | .claude/skills/ |
仅当前项目 |
| 插件 | 通过插件市场安装 | 按需启用 |
优先级从高到低：企业 > 个人 > 项目。同名 Skill 高优先级覆盖低优先级。
分享方式主要两种：一是提交到代码仓库，把 Skills 放在项目的 .claude/skills/ 目录下 push 到 Git；二是发布到插件市场，创建 marketplace.json 定义插件列表和来源，团队成员用 /plugin marketplace add 添加后按需安装。
Anthropic 内部的做法值得借鉴：没有专门的审核团队，而是让好的 Skills 自然浮现——先放沙盒让人试用，有人用了、有效果了，再正式上架。
值得关注的 Skills 资源
几个有实际价值的 Skills 合集：
基础必装：
anthropics/skills——Anthropic 官方出品，最权威的合集openai/skills——OpenAI 的 Skills，跨平台借鉴意义大
出海 SaaS 开发者技术栈：
neondatabase/agent-skills——Neon Serverless 数据库supabase/agent-skills——Supabase 全栈后端stripe/ai/skills——Stripe 支付集成- Cloudflare 生态相关 Skills
这套组合拼起来，搭一个 SaaS 产品的后端 + 支付 + 部署，Claude 基本可以一条龙完成。
内容创作方向：
JimLiu/baoyu-skills——覆盖公众号、小红书、封面图、翻译等内容创作全流程typefully/agent-skills——Twitter/X 发帖相关remotion-dev/skills——Remotion 视频制作
一站式导航：
VoltAgent/awesome-agent-skills——社区优质 Agent Skills 合集，按类别整理并持续更新
怎么判断一项工作该不该做成 Skill
回到最本质的问题：Skills 到底是什么？
把它想成 SOP 手册就对了。团队里的 SOP 是把「做过的人」的经验总结成标准流程，让「没做过的人」也能按步骤执行出相同结果。Skills 做的事情一模一样，只是执行者从人换成了 Claude。
判断标准因此变得很简单：凡是能沉淀成 SOP 的工作，就能做成 Skill。能被抽象成 Skill 的工作通常有三个特征——功能稍微复杂、是独立的小单元、有固定流程或已知的难点。
Anthropic 数百个 Skills 的经验中有一条最值得记住：大多数好用的 Skills 最初只有几行，是在不断使用中补充 Gotchas、丰富模板、优化触发条件后才变得强大的。不要试图一次写出完美的 Skill，从最小可用版本开始，让实际使用来驱动迭代。