Skill 从入门到精通：Claude Code 技能系统完全指南

从安装第一个 Skill 到发布自己的 Skill、从个人提效到商业变现，这份指南覆盖 Skill 生态的每一个环节。

---

第一章：理解 Skill——它到底是什么

1.1 一句话定义

Skill 是写给 Claude Code 的操作手册，让它在特定场景下按你规定的方式执行任务。

1.2 Skill 与 Prompt 的本质区别

• Prompt 是一次性指令，用完即弃
• Skill 是可复用的流程资产，写一次、用无数次
• 类比：Prompt 像口头吩咐，Skill 像员工手册

1.3 Skill 的三层加载机制

层级	内容	何时加载
Level 1	名称 + description	始终在上下文中
Level 2	SKILL.md 正文	技能被触发时
Level 3	scripts / references / assets	按需加载

为什么 description 是整个 Skill 的灵魂——它决定 Claude 什么时候"想起"用你的 Skill。

1.4 Skill 的文件结构

my-skill/
├── SKILL.md          # 技能定义（YAML 前置 + Markdown 正文）
├── scripts/          # 确定性操作脚本
├── references/       # 领域知识文档（按需加载）
├── assets/           # 模板和素材（不进上下文）
└── LICENSE.txt

四类文件各自的职责和设计原则。

1.5 Skill 与 MCP、Hook、CLAUDE.md 的关系

• CLAUDE.md：全局规则，始终生效
• Hook：事件驱动的自动化脚本
• MCP：连接外部服务的协议层
• Skill：场景化的工作流定义

四者如何配合，各自适合解决什么问题。

---

第二章：安装和使用 Skill

2.1 安装 Skill 的三种方式

• 命令行安装：npx skills add author/repo
• 手动安装：将 Skill 目录放入 ~/.claude/skills/
• 通过 Claude Code 对话安装：直接告诉它从哪个仓库安装

2.2 哪里找到高质量 Skill

• GitHub 搜索与筛选策略
• Anthropic 官方 Skill
• 社区热门 Skill 集合（baoyu-skills 等）
• 如何评估一个 Skill 的质量：读 description、看结构、试一次

2.3 Skill 的三种类型与选择标准

能力型：提供你本地没有的底层能力（pdf、xlsx、docx、pptx） 参考型：包含高质量领域知识（claude-api、brand-guidelines） 流程型：封装特定工作流程（wechat-publisher、tweet-writer）

核心判断：能力型和参考型可以装别人的，流程型应该自己写。

2.4 安装数量的上限

• 为什么 Skill 不是越多越好
• 触发词污染：20-30 个是体验拐点
• 控制在 10-15 个以内的实践建议
• 每月清理一次的习惯

2.5 装之前的三个自检问题

1. 过去一个月做过三次以上这类任务吗？
2. 触发词会不会和现有 Skill 撞车？
3. 这个 Skill 的能力，我自己一天能写出来吗？

---

第三章：开发自己的 Skill

3.1 什么任务值得做成 Skill

值得：有稳定流程的任务——骨架固定，血肉变化

• 发布文章、生成封面、写 commit message、从 PDF 提取内容

不值得：依赖当下判断的任务

• Code Review、调试 Bug、回答具体技术问题

介于两者之间：把子流程单独做成 Skill

3.2 沉淀的四个阶段

1. 手工重复：第一次做，所有步骤靠 Prompt 推进，不急着写 Skill
2. 整理步骤清单：做到第二三次，把固定部分和变动部分分开
3. 写 Skill 骨架：想清楚触发词、边界、步骤、参考文件
4. 用了再改：每次使用后迭代，Skill 是养出来的

3.3 SKILL.md 的完整格式

---
name: my-skill
description: >
  清晰的功能描述 + 具体的触发短语 + 双语关键词
version: 1.0.0
allowed-tools: [Bash, Read, Write, Edit, WebFetch]
---

正文结构：概述 → 工作流程 → 关键规则 → 参考资源

3.4 description 的写作技巧

• 功能描述（What）：这个 Skill 做什么
• 触发短语（When）：穷举用户可能说的表达，包括中英文
• 排除条件（When Not）：明确不做什么
• 反面案例与正面案例对比

3.5 "自由度匹配"原则

自由度	实现方式	适用场景
高	纯文本指令	写文章、做设计决策
中	伪代码 + 参数	API 集成、数据处理
低	具体脚本	PDF 表单填写、图片格式转换

核心：Claude 已经很聪明了，只补充它不知道的领域知识。

3.6 脚本、参考文件和资源的设计

• scripts/：什么操作该写成脚本（确定性强、不需 AI 判断的任务）
• references/：什么内容该放参考文档（API 文档、行业规范、数据 Schema）
• assets/：什么东西该当模板（HTML 骨架、报告结构、样式文件）
• 控制 Token 消耗：SKILL.md 正文不超过 500 行，大文档按需加载

3.7 实战案例：从零开发一个完整 Skill

选一个具体案例（如竞品分析报告生成器），完整走一遍：

• 明确用户场景
• 规划文件结构
• 编写 SKILL.md
• 开发辅助脚本
• 测试与迭代

3.8 三个常见误区

1. 追求大而全——宁拆三个小 Skill，不做一个胖 Skill
2. 把配置写死——API key、路径等放环境变量，不放 Skill 内
3. 写完就不管——每次用都问自己"哪里能改"

---

第四章：从 Skill 到 Plugin——打包多个技能

4.1 什么时候需要 Plugin

• 当你的 Skill 超过三个且属于同一领域
• 需要共享配置、脚本或参考文件
• 想作为一个整体分发给用户

4.2 Plugin 的文件结构

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   ├── skill-a/
│   ├── skill-b/
│   └── skill-c/
├── README.md
└── LICENSE

4.3 plugin.json 的编写

元数据字段、版本管理、依赖声明。

4.4 Skill 之间的协作设计

• 子 Skill 调用：一个 Skill 触发另一个 Skill
• 共享资源：多个 Skill 复用同一份参考文档或脚本
• 避免触发词冲突：Plugin 内部的关键词协调

---

第五章：发布到 Skill 商店和社区

5.1 发布渠道一览

渠道	特点	适合谁
GitHub 开源仓库	最通用，开发者友好	所有人
Anthropic 官方 Marketplace	权威，审核严格	高质量 Skill
第三方 Skill Hub	社区驱动，门槛低	快速分发
个人网站/博客	完全自主，品牌绑定	有流量基础的作者

5.2 发布前的质量检查清单

• SKILL.md 格式验证（YAML 前置、name 规范、description 长度）
• 触发词测试：是否精准触发、是否误触发
• 功能测试：至少覆盖三种典型输入
• 文档完整性：README、安装说明、使用示例、截图
• 安全审查：不包含硬编码的密钥、不执行危险操作

5.3 README 的写作

• 用 30 秒抓住读者：问题 → 方案 → 效果
• 安装命令放在最显眼的位置
• 提供使用截图或 GIF 演示
• 列出前置依赖和配置步骤

5.4 版本管理与更新策略

• 语义化版本号：major.minor.patch
• CHANGELOG 的维护
• 向后兼容的重要性
• 如何通知用户更新

5.5 开源许可证的选择

• MIT：最宽松，适合想最大化传播的 Skill
• Apache 2.0：带专利保护
• GPL：要求衍生作品也开源
• 商业许可：可开源可付费的双许可模式

---

第六章：运营 Skill——从发布到持续增长

6.1 冷启动：前 100 个用户怎么来

• 在技术社区发介绍文章（掘金、知乎、V2EX、Hacker News）
• Twitter/X 上展示使用效果
• 找 3-5 个种子用户做深度测试
• 提交到 Awesome Claude Code 类的汇总列表

6.2 用户反馈的收集与处理

• GitHub Issues 的规范化管理
• 区分"功能请求"和"Bug 报告"
• 哪些反馈该响应，哪些该拒绝
• 用反馈驱动迭代：每两周一个小版本

6.3 社群运营

• 建立用户群（Discord / Telegram / 微信群）
• 定期分享使用技巧和更新日志
• 让活跃用户成为贡献者
• 社群规模与运营精力的平衡

6.4 内容营销

• 围绕 Skill 写系列文章：原理、教程、案例、对比
• 录制使用视频或 GIF 演示
• 在 Skill 解决的垂直领域建立专业形象
• 内容反哺 Skill：文章带来用户，用户带来反馈，反馈改进 Skill

6.5 数据驱动的运营

• 关注哪些指标：Star 数、Fork 数、Issue 活跃度、实际安装量
• 哪些指标是虚荣指标，哪些反映真实价值
• 如何判断一个 Skill 是否值得继续投入

---

第七章：用 Skill 变现——六条路径

7.1 路径一：开源引流 → 付费服务

• 核心 Skill 免费开源，获客成本趋近于零
• 付费增值：定制化 Skill 开发、企业部署咨询、一对一工作流优化
• 收入模型：定制开发 5000-50000 元/个，月度咨询 3000-10000 元/月

7.2 路径二：垂直行业 Skill 订阅

• 针对特定行业（跨境电商、法律、财税、教育、自媒体）开发 Skill 套件
• 以订阅制出售，月费 99-499 元
• 关键成功要素：真正懂行业、持续迭代、用户反馈闭环

7.3 路径三：企业 Skill 定制开发

• 为企业编码内部知识和流程
• 报价逻辑：简单 Skill 5000-15000 元，中等 15000-50000 元，复杂套件 50000-200000 元
• 获客方式：通过开源影响力转化

7.4 路径四：Skill 即轻量 SaaS

• 很多轻量级工具可以用 Skill 替代传统 SaaS
• 开发成本几乎为零，维护成本几乎为零
• 局限：依赖 Claude Code 生态，不适合需要实时数据库的场景

7.5 路径五：教育与培训

• 录制 Skill 开发课程
• 举办 Skill 开发工作坊
• 写书或系列教程
• 做 Skill 开发的付费社群

7.6 路径六：做 Skill 的分发平台

• Skill 市场、评测推荐、模板市场
• 风险最高但天花板最高
• 适合有平台运营经验的团队

7.7 选择变现路径的决策框架

你的优势	推荐路径
技术能力强，有垂直行业经验	路径二（行业订阅）
有企业客户资源	路径三（定制开发）
擅长内容创作和教学	路径五（教育培训）
想快速验证市场	路径一（开源引流）

---

第八章：让自己的项目支持 Skill

8.1 为什么要让项目支持 Skill

• 降低用户的上手门槛：用自然语言操作你的项目
• 扩展项目的使用场景：从命令行工具变成 AI 原生工具
• 构建生态壁垒：围绕你的项目形成 Skill 社区

8.2 为开源项目编写官方 Skill

• 分析项目的核心操作：哪些 CLI 命令或 API 调用最常用
• 把常用操作封装为 Skill：安装、配置、典型工作流
• 把项目文档转化为 references/：让 Claude 随时查阅
• 实例：一个 CLI 工具如何用 Skill 包装

8.3 把 Skill 作为项目文档的补充

• 传统文档 vs Skill 文档
• 传统文档告诉人怎么做，Skill 告诉 AI 怎么做
• 两者并行维护的策略

8.4 项目级 Skill 的部署方式

• 放在项目仓库的 .claude/skills/ 目录
• 通过 CLAUDE.md 引用
• 与 CI/CD 配合：在特定环节自动触发 Skill

8.5 为 API 或 SDK 项目提供 Skill 集成

• 把 API 文档放进 references/
• 把常见用法封装为 Skill 步骤
• 让用户说一句话就能完成 API 集成
• 降低 API 产品的使用门槛

8.6 Skill 生态运营

• 鼓励社区贡献 Skill：提供贡献指南和模板
• 官方 Skill 与社区 Skill 的关系
• Skill 的质量标准与审核机制
• 从 Skill 生态反哺项目的改进方向

---

第九章：进阶技巧与最佳实践

9.1 Token 效率优化

• SKILL.md 正文控制在 500 行以内
• 大段参考资料放 references/，用 grep 模式按需加载
• 避免在 description 里塞太多内容（1024 字符上限）

9.2 触发词工程

• 如何设计不冲突的触发词体系
• 中英文双语触发的最佳实践
• 否定触发：明确写出"不要在 X 场景触发"
• 测试方法：用多种表述验证触发准确度

9.3 Skill 之间的组合与编排

• 子 Skill 调用模式
• 流水线 Skill：A 的输出是 B 的输入
• 避免循环依赖

9.4 调试 Skill 的方法

• 观察 Claude 是否正确触发
• 检查 Level 2 加载的内容是否符合预期
• 常见问题排查：触发不了、触发错误、步骤遗漏、输出格式不对

9.5 Skill 的版本迭代策略

• 小步快跑：每次只改一个地方
• 保留旧版本记录
• 向后兼容的原则

9.6 安全与权限

• Skill 中的敏感信息处理
• allowed-tools 的最小权限原则
• 用户信任与 Skill 安全的平衡

---

第十章：Skill 生态的未来

10.1 当前生态的阶段判断

• 类比 iPhone App Store 2008 年：平台已搭好，优质应用严重不足
• 先发优势窗口期的长度预估
• 从个人开发者到团队化运营的趋势

10.2 Skill 可能的演进方向

• 更丰富的触发机制：事件触发、定时触发、条件触发
• Skill 之间的标准化通信协议
• 可视化 Skill 编辑器
• Skill 运行时的沙箱与权限管理

10.3 对开发者的建议

• 现在入场，选一个你最懂的垂直领域
• 先做一个真正好用的 Skill，再考虑变现
• Skill 的核心竞争力永远是领域知识，而非技术实现

---

附录

附录 A：SKILL.md 完整模板

提供一个可直接复制使用的 SKILL.md 模板，包含所有字段和注释。

附录 B：常用工具与资源

• skill-creator：Skill 开发的元技能
• mcp-builder：MCP 开发指南
• 验证脚本与打包工具
• 社区资源链接

附录 C：Skill 开发检查清单

从构思到发布的完整 checklist，每个环节的关键检查项。

附录 D：词汇表

Skill、Plugin、MCP、Hook、CLAUDE.md、description、触发词等核心概念的简明定义。