ORANGE BOOK · AGENT SKILL

第十二章 从用户到创造者

你将学到

  • 把你的 Skill 从"自己用"变成"100 人在用"的完整发布流程。
  • 写一份让人 30 秒就想 install 的 README。
  • 提交到 PolySkill / 5tldr / SkillsHunt 三大市场的步骤。
  • 5 条把 Skill 创作变成长期收入的路径。
  • 4 条长期成长原则——让你 5 年后仍在前 1%。

你需要准备

  • 至少 1 个你已经写过、自己用了 1 周以上的 Skill。
  • 一个 GitHub 账号（github.com/signup 免费注册）。
  • 大约 1 小时（含 GitHub 配置）。

温馨提示：这一章不要"读完就放下"。当天晚上把你的第一个 Skill 发出去——拖到第二天，90% 的人就再也不发了。

一、为什么"发出去"这件事这么重要

1.1 个人成长

你写一个只给自己用的 Skill，可能 70 分就够。 你写一个要发给陌生人用的 Skill，会自然要求自己做到 90 分——因为有人在看。

这种"被看见"的心理压力，是最好的成长加速器。

1.2 反馈飞轮

发出去后，会有人提 Issue：

  • "我装了在 Windows 跑不了"
  • "你这个 description 应该加一个英文版"
  • "如果加一个 -p 参数让我自定义就完美了"

这些反馈是你花钱也买不到的产品教育。

1.3 社区位置

在 Skill 这个新生态里，早期贡献者拿到的是品牌势能。3 年后回头看，今天写下第一个 Skill 的你，就是 2026 年版的"第一批 NPM package 作者""第一批 Chrome Extension 开发者"。

1.4 副业基础

第六节会详细讲：发出去的 Skill 是你副业的基石。你不发，就没有任何"被人付钱"的可能。

二、发布前 7 项检查

发布之前，把你的 Skill 按下面清单过一遍：

Checklist

  • 名字符合 kebab-case：小写 + 短横线，简短描述。
  • description 写得像触发器：含中英文关键词，覆盖典型场景。
  • allowed-tools 已设置：最少权限原则。
  • 使用过 ≥ 7 天：自己跑过至少 20 次，没有明显 bug。
  • 3 种 test prompt 都通过：标准/缺信息/极端输入。
  • 没有硬编码任何 token / 路径 / 个人信息。
  • dependencies 完整：第一次跑能自动装包跑通。

7 项全过了再发。

三、把 Skill 推到 GitHub（手把手）

3.1 GitHub 账号准备

如果还没有：

  1. github.com/signup 注册（用邮箱，记好密码）。
  2. 配置 SSH key：
ssh-keygen -t ed25519 -C "your-email@example.com"
cat ~/.ssh/id_ed25519.pub

复制输出，去 GitHub Settings → SSH Keys → Add new。

  1. 测试：
ssh -T git@github.com

应该看到 "Hi yourname! You've successfully authenticated..."。

3.2 创建仓库

GitHub 网页右上角 + → New repository：

  • Repository name: 与 Skill 同名，如 weekly-reading-list。
  • Description: 一句话描述（与 SKILL.md 的 description 类似）。
  • Public: 选 Public（让别人能装）。
  • 不要勾任何 README、.gitignore、license（我们自己加，避免冲突）。
  • 点 Create。

3.3 本地推送

cd ~/.claude/skills/weekly-reading-list
git init
git add .
git commit -m "Initial release: weekly reading list generator v1.0.0"

# 用 GitHub 给的地址（在 Quick setup 部分能看到）
git remote add origin git@github.com:yourname/weekly-reading-list.git
git branch -M main
git push -u origin main

刷新仓库页面，应该能看到 SKILL.md 等文件。

3.4 加 LICENSE

在仓库根目录建 LICENSE 文件。最适合 Skill 的开源协议是 MIT（最宽松）或 Apache 2.0（含专利保护）。

MIT 模板（替换 <year> 和 <name>）：

MIT License

Copyright (c) <year> <name>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

提交：

git add LICENSE
git commit -m "Add MIT license"
git push

3.5 加 .gitignore

避免把 secrets / 临时文件提交：

# Secrets
*.token
*.secret
secrets/
.env
.env.*

# Python
__pycache__/
*.pyc
.venv/
venv/

# OS
.DS_Store
Thumbs.db

# IDE
.vscode/
.idea/

# Output
*.log
output/
tmp/

git add .gitignore
git commit -m "Add .gitignore"
git push

四、写一份让人 30 秒想装的 README

README 是仓库门面。一份好 README 让你的 Star 数翻 10 倍。

4.1 黄金结构（5 段）

# <Skill 名字>

> 一句话价值主张（≤ 30 字）

## 它能解决什么（具体到痛点）

[2–3 行描述场景，让读者拍大腿"对对对就是这个！"]

## 30 秒装上去

```bash
/plugin add github.com/yourname/<skill-name>

或手动：[详细步骤]

用一次

[贴一张实际效果截图 / 一段对话示例]

高级用法

[2–3 个进阶玩法]

反馈与贡献

提 Issue / PR / 加微信群 …


### 4.2 一份"满分 README"示例

```markdown
# weekly-reading-list

> 让 Claude 每周给你挑 3–5 本最值得读的书。

## 你是不是也...

- 每周想读书，但选择困难症发作
- 收藏夹 200 本想读，最后一本没翻
- 朋友推荐的书读完没感觉，自己挑的又不知道好不好

这个 Skill 让 Claude 像一个"懂你的读书顾问"——
基于你的阅读历史和本周心情，挑出 3–5 本**适合现在的你**的书。

## 30 秒装上去

### Claude Code:
```bash
/plugin add github.com/cassius/weekly-reading-list

Claude.ai 网页版:

  1. 下载本仓库的 zip
  2. Settings → Capabilities → Skills → Upload

用一次

打开 Claude，说：

帮我挑本周读书清单。 主题：想懂宏观经济一点点，但我没基础。 可用时间：通勤每天 1 小时 + 周末 3 小时。 偏好：故事性强一些。

输出：

# 📚 本周读书清单 — 2026-04-19

> 主题：想懂宏观经济一点点，但我没基础
> 共 4 本书 / 预计 7.5 小时

## 1. 《置身事内》— 兰小欢
- 类别：经济 + 政治
- 推荐理由：用真实案例讲懂中国经济运行
- 预计时长：3 小时
- 阅读建议：先读前 3 章，找体感

## 2. ...

高级用法

给 Claude 你的阅读历史

[拖入 douban-export.csv]
基于这份豆瓣记录，挑本周清单。

设定语气风格

本周清单用文艺青年的口吻，复述部分能引用作者原句更好。

自动追加到 Notion

配合 notion-pusher Skill 使用，挑完书自动加进你的 Notion 阅读数据库。

反馈

  • 有 bug？提 Issue
  • 想贡献？欢迎 PR
  • 想交流？加微信 xxx 备注 "weekly-reading-list"

许可

MIT


### 4.3 README 的 5 个加分项

1. **GIF/截图**：录一段 30 秒动图（用 [Kap](https://getkap.co)）展示效果。
2. **徽章**：在标题下加 Star / Downloads / License 徽章（[shields.io](https://shields.io) 一键生成）。
3. **English version**：海外用户多，加一个 `README.en.md` 价值翻倍。
4. **Changelog**：维护 `CHANGELOG.md`，让用户看到你在持续更新。
5. **Demo 链接**：如果可能，做一个 [demo.skill.run](#) 链接让别人不装就能试。

---

## 五、提交到三大社区市场

### 5.1 提交到 5tldr/claude-skills

最大的 Skill 集合仓库。提交方式：

1. Fork [https://github.com/5tldr/claude-skills](https://github.com/5tldr/claude-skills)。
2. 在你的 fork 里加你的 Skill：
   - 把你 Skill 整个文件夹加到 `community/your-skill/`。
   - 在主 README 表格里加一行（按字母序）。
3. 提 PR 到上游，描述：
   - 解决什么痛点
   - 用一次的截图
   - 已被几个人用过

### 5.2 提交到 PolySkill

PolySkill 走"作者主页"模式：

1. 注册 [polyskill.ai](https://polyskill.ai) 账号。
2. Settings → Connect GitHub。
3. Submit → 填表（Skill 名、描述、GitHub 地址、分类、截图）。
4. 等审核（通常 1–3 天）。

### 5.3 提交到 SkillsHunt

SkillsHunt 中文用户多：

1. 注册 [skillshunt.io](https://skillshunt.io)。
2. 上传你的 Skill 包（zip）或填 GitHub 地址。
3. 选标签（方便用户搜索）。
4. 提交。

### 5.4 同时分享到中文社区

- 公众号：写一篇 "我做了一个 xxx Skill" 文章，附 GitHub 链接。
- 小红书：用图文 + 30 秒视频展示效果。
- B 站：录 1 分钟"实测"视频。
- 即刻：发动态，重点写"为什么做这个"。
- V2EX / Hacker News：技术社区，按规则发布。

> 第一次发不要期待爆款。重点是"开始有人看见你"。

---

## 六、5 条把 Skill 变成副业的路径

### 路径 1：免费 Skill + 咨询变现

发布免费 Skill → 在 README 留咨询微信/邮箱 → 有用户来咨询付费定制 → 接单。

**适合**：你有一个被广泛用的免费 Skill，且愿意 1on1 服务。

**真实数据**：社区里头部 Skill 作者，靠咨询月入 5k–30k 不等。

### 路径 2：付费 Skill + 订阅

把"复杂版本"做成付费 Skill。比如免费版只支持 1 个数据源，付费版支持 10 个 + 自动调度 + 邮件提醒。

**适合**：有明显"个人版/专业版"区分的 Skill，如销售工具、招聘工具、财务工具。

**渠道**：[Gumroad](https://gumroad.com)、[Lemon Squeezy](https://lemonsqueezy.com)、[Stripe Payment Links](https://stripe.com)。

### 路径 3：Skill 包 + 教程

不卖单个 Skill，卖"一整套行业 Skill 包"。比如：
- 「销售小能手 Skill 包」：含 10 个销售场景 Skill + 1 本电子书 + 1 个微信群。
- 「自由职业者 Skill 包」：含报价单、合同生成、客户跟进等 8 个 Skill。

**适合**：垂直行业有沉淀的人。

**定价**：99–999 元一次买断，或 49 元/月订阅。

### 路径 4：定制 Skill 接单

成为"AI 自动化顾问"。中小公司痛点：

- "帮我们做一个邮件分类 Skill"
- "帮我们对接 Notion"
- "帮我们把销售流程 Skill 化"

**适合**：能出去见客户、有耐心做需求收集的人。

**单价**：500–10000 元/Skill（按复杂度）。

### 路径 5：内容 IP

围绕 Skill 做长期内容：
- 公众号 / 小红书：每周一个新 Skill。
- B 站：实战视频。
- 知识星球 / Discord：高质量 Skill 内容订阅。

**适合**：会写、爱分享的人。

**变现**：广告、知识付费、品牌合作。

> **现实提醒**：副业不是"装个 Skill 就赚钱"。是"装得多、做得专、传得远、跟得久"。

---

## 七、加入 Skill 创作者社区

### 7.1 三个值得加入的社区

| 社区 | 性质 | 怎么加入 |
| --- | --- | --- |
| Anthropic Discord | 官方社区 | [discord.gg/anthropic](https://discord.gg/anthropic)（示例链接） |
| PolySkill Builders | 创作者群 | PolySkill 网站申请 |
| 中文 Skill 创作者群 | 民间组织 | 在 SkillsHunt 找"加入社群"入口 |

### 7.2 在社区里"被看见"的方式

- 不要发广告。先看别人聊啥，参与讨论。
- 别人提问时，如果你能答，详细回。
- 每次发新 Skill 在社区发一个 "show your work" 帖。
- 维护一个个人主页，简介里写明 Skill 创作者身份。

### 7.3 长期回报

社区是你 Skill 之路最强大的"复利发动机"：

- 你的 PR 容易被 merge（认识维护者）
- 你的 Skill 容易被推荐（认识 marketer）
- 你需要找工作时，HR 在 LinkedIn 上能看到你 = 一份不写 PPT 的"AI 简历"
- 你的副业容易接单（社区口碑传播）

---

## 八、4 条长期成长原则

### 原则 1：每周 1 个 Skill，比每月 1 个完美 Skill 更重要

新手最容易陷入"完美主义"——憋一个月写一个"超级 Skill"。

错。频次 > 质量。

每周 1 个简单 Skill，1 年 = 50 个 Skill。这 50 个里能有 5 个被 100+ 人用，已经是顶尖创作者了。

### 原则 2：解决"自己的"痛点，不要解决"别人想象的"痛点

最受欢迎的 Skill 永远是"作者自己每天都用的"。

不要去预测"市场需要什么"。**做你昨天加班 2 小时想骂人的事情**，那就是你的下一个 Skill。

### 原则 3：把 Skill 当作"小公司"运营

每个 Skill 都有它自己的：
- 用户（谁在装它）
- 反馈循环（Issue / 评论）
- 路线图（v1 → v2）
- 营销（README + 社区帖子）

把它当一个小生意来运营，而不是"开源情怀"。

### 原则 4：长期主义——5 年视角

今天的 Skill 生态，相当于：
- 2008 年的 iPhone App Store
- 2014 年的 Chrome Extension Store
- 2018 年的 GitHub Action Marketplace

这些生态早期 Top 100 的开发者，5 年后大部分都做出了名堂——卖给大厂、自己创业、成为行业 KOL。

**今天你写第 1 个 Skill 的姿势，会决定 5 年后的你站在哪里。**

---

## 九、给 5 年后的你的一封信

亲爱的你：

5 年前的某个晚上，你读完了《Agent Skill 橙皮书》的最后一章，
合上电脑，去睡觉。

第二天早上，你在 GitHub 上发布了第一个 Skill。
那时候你只有 2 个 Star——其中一个还是你自己点的。

这 5 年里，你写了几百个 Skill。有几个被广泛传播，
有几个让你赚到了第一笔副业收入，
有几个让你在公司年会上被点名"AI 自动化达人"，
有几个在朋友的婚礼上被人提起："就是写那个 Skill 的人"。

你帮过爸妈，让他们 80 岁还能用 AI 处理生活。
你帮过爱人，让她不再加班到凌晨 2 点。
你帮过陌生人——一个非洲的医生用你的 Skill 整理病历，
一个东南亚的学生用你的 Skill 写论文。

这一切都始于那个晚上你按下的那个 `git push`。

继续写下去。

---

## 十、本章一图回顾

+-----------------------------------------------------------+ | 从用户到创造者完整路径 | +-----------------------------------------------------------+ | 阶段 0: 自己用 1 周 + 通过 7 项检查 | | 阶段 1: 推到 GitHub | | → 仓库 + LICENSE + .gitignore | | 阶段 2: 写一份会让人 30 秒就装的 README | | → 5 段结构: 解决问题 / 装 / 用 / 进阶 / 反馈 | | 阶段 3: 提交三大市场 | | → 5tldr / PolySkill / SkillsHunt | | 阶段 4: 同步到中文社区 | | → 公众号 / 小红书 / B 站 / 即刻 | | 阶段 5: 持续迭代 | | → 收 issue / 改 / 发 v2 | +-----------------------------------------------------------+ | 5 种副业路径 | | 1. 免费 Skill + 咨询 | | 2. 付费 Skill + 订阅 | | 3. Skill 包 + 教程 | | 4. 定制 Skill 接单 | | 5. 内容 IP | +-----------------------------------------------------------+ | 4 条长期原则 | | 1. 频次 > 质量 | | 2. 解决自己的痛点 | | 3. 当作"小公司"运营 | | 4. 5 年视角 | +-----------------------------------------------------------+


## 给你 3 句话提醒

1. 今晚就发布。明天就来不及了。
2. 你的第一个 Skill 一定不完美——这没关系。第二个会好一点，第十个就够好了。
3. 5 年后你回头看，今晚是分水岭。

## 全书总结

恭喜你读完了这本书。

我们从 [00 序言](preface.html) 的"小苏 vs 小林"开始，
经过 [01 类比](ch01-认识agentskill.html) 的"应用商店 + 入职手册 + 肌肉记忆"，
[02 五分钟初体验](ch02-五分钟初体验.html) 跑通了第一个 Skill，
[03 原理](ch03-skill是怎么工作的.html) 看清了渐进式披露，
[04 官方 Skill](ch04-从官方skill开始.html)、[05 社区市场](ch05-从社区市场安装skill.html) 学会装别人的，
[06 生活](ch06-生活场景实战.html)、[07 工作](ch07-工作场景实战.html) 跑通了 15 个真实案例，
[08 第一个 Skill](ch08-写自己的第一个skill.html)、[09 进阶](ch09-skill进阶.html) 学会写自己的，
[10 安全](ch10-skill的安全与隐私.html)、[11 避坑](ch11-避坑指南.html) 让你不踩雷，
最后这一章 12 让你从用户变成创造者。

---

接下来是 5 个附录：

- [附录 A 常用 Skill 速查表](appendix-a-常用skill速查表.html) — 50+ 高质量 Skill 一页查
- [附录 B 30 个开箱即用提示词](appendix-b-30个开箱即用提示词.html) — 30 个完整可复制 Prompt
- [附录 C 术语表](appendix-c-术语表.html) — 30+ 个术语速查
- [附录 D 资源与社区链接](appendix-d-资源与社区链接.html) — 官方 / 市场 / 社区一站式
- [附录 E 100 项达成清单](appendix-e-100项达成清单.html) — 把全书拆成 100 个可打卡任务

把它们当作字典常翻。

---

> 这本书的版权是 CC BY-SA 4.0，免费传播。
>
> 如果它帮到了你，最好的"赞赏"就是把它转发给一位还在用纯聊天 AI 的朋友——
> 让他也跨进 Skill 的世界。
>
> 也欢迎你写自己的橙皮书。一本写给爸妈的、一本写给团队的、一本写给孩子的。
> 把这本书继续传下去。
>
> 走吧。
> 去发布你的第一个 Skill。

—— 全书完