Skill 从小白到高手系列课
附录 D：参考资源
每个资源都说明了"对我有什么用"，帮你快速判断值不值得看
所有链接截至 2026-04-11 有效
官方规范
Agent Skills 开放规范
- 链接：https://agentskills.io
- 这是 Skill 的官方规范网站。如果你想知道 SKILL.md 里每个字段的精确定义、约束条件、正反例，这是权威来源。网站还提供了格式验证工具——把你的 SKILL.md 贴进去，它能告诉你哪里写错了。每次做完新 Skill 跑一遍验证，能避免很多低级错误。
SKILL.md 格式规范
- 链接：https://agentskills.io/specification
- 上面那个网站的子页面，专门讲格式规范。比主站更详细，包含完整的字段定义表。name 的命名规则、description 的字数上限、allowed-tools 的安全约束，都在这里有说明。写 Skill 的时候建议把这个页面开着随时对照。
Anthropic 官方文档
- 链接：https://docs.anthropic.com/en/docs/claude-code/skills
- Anthropic 官方写的 Skill 使用文档。侧重于"怎么在 Claude Code 里使用 Skill"，包括安装位置、触发机制、和 MCP 的配合等。如果你用的是 Claude Code，这个页面是必读的。
Anthropic 官方教程
- 链接：https://learn.deeplearning.ai/courses/agent-skills-with-anthropic/
- Anthropic 和 DeepLearning.AI 合作的视频课程，英文。大约 1 小时，从零开始讲 Skill 的概念、创建和使用。适合喜欢看视频学习的同学。课程里有动手练习环节，跟着做完你会有一个完整的 Skill。
社区 Skill 库
awesome-claude-code
- 链接：https://github.com/hesreallyhim/awesome-claude-code
- Stars：38k
- 目前最全的 Claude Code 资源索引。不只是 Skill，还包括提示词、配置技巧、插件推荐等。想找什么资源，先来这里搜一遍。更新频率很高，基本每周都有新内容。
awesome-claude-skills
- 链接：https://github.com/ComposioHQ/awesome-claude-skills
- Stars：52.9k
- 专门收集 SaaS 自动化 Skill 的仓库，78 个现成的 Skill。如果你想让 AI 自动操作 Slack、Notion、Google Sheets 这类工具，这里大概率能找到现成的。每个 Skill 都有使用说明和配置方法。
antigravity-awesome-skills
- 链接：https://github.com/sickn33/antigravity-awesome-skills
- Stars：32.1k
- 目前最大的 Skill 合集之一，收录了 1397+ 个可安装的 Skill。分类很清晰，按功能领域组织。适合你不确定自己需要什么 Skill 的时候逛一逛，看看别人都做了什么。
awesome-agent-skills
- 链接：https://github.com/VoltAgent/awesome-agent-skills
- Stars：15.1k
- 跨平台的 Agent Skill 合集，1000+ 个。不只是 Claude Code，还涵盖了其他 AI Agent 平台的 Skill。如果你同时用多个 AI 工具，这个仓库帮你找到通用的资源。
Anthropic 官方 Skill 库
- 链接：https://github.com/anthropics/skills
- Anthropic 官方维护的 Skill 仓库。数量不多，但质量最高，每个都是经过测试的。如果你想学习"官方推荐"的 Skill 写法，看这个仓库里的代码是最好的教材。
怎么用 Skill 库
- 先搜后写：写新 Skill 前先在这些库里搜一下，可能已经有人写了类似的。
- 学习写法：看别人的 Skill 怎么写 description、怎么组织步骤、怎么处理边界情况。
- 直接安装：大部分 Skill clone 下来放到
.claude/skills/ 目录就能用。
- 改造复用：找到接近需求的 Skill，在此基础上改造成你要的样子，比自己从零写快很多。
本教程配套 Skill（已安装在 .claude/skills/）
你的项目目录 .claude/skills/ 下已经安装了几个真实的 Skill，供你学习和参考：
| Skill | 级别 | Stars | 适合学习 | 位置 |
|---|
| avoid-ai-writing | L1 | 887 | 单文件 Skill、词汇替换规则、Context Profiles | .claude/skills/avoid-ai-writing/ |
| content-pipeline | L2 | 111 | 国内多平台内容发布（公众号/小红书/微博等）、references 拆分 | .claude/skills/content-pipeline/ |
| xiaohongshu-skills | L3 | 1k | 模块化设计、Skill 合集组织、领域深耕 | .claude/skills/xiaohongshu-skills/ |
| ui-ux-pro-max | L2 | - | 优先级分层、反模式表格、检查清单 | .claude/skills/ui-ux-pro-max/ |
查看和学习方法
cat .claude/skills/avoid-ai-writing/SKILL.md
cat .claude/skills/content-pipeline/SKILL.md | head -200
ls .claude/skills/content-pipeline/references/
ls .claude/skills/xiaohongshu-skills/skills/
cat .claude/skills/xiaohongshu-skills/skills/01-内容创作/title-writing/SKILL.md
cat .claude/skills/ui-ux-pro-max/SKILL.md | grep -A 20 "P0"
这些 Skill 在教程中的位置
- avoid-ai-writing：模块 1（入门案例）、模块 5B（L1 级别拆解）
- content-pipeline：模块 5B（L2 级别拆解）、模块 6（性能优化案例、安全审查案例）
- xiaohongshu-skills：模块 5B（L3 级别拆解）
- ui-ux-pro-max：模块 5A（完整拆解）
按领域的 Skill 推荐
自媒体/内容创作（搜索量最高）
这是搜索量最高的领域，社区资源也最丰富。
xiaohongshu-skills
- 链接：https://github.com/vivy-yi/xiaohongshu-skills
- Stars：1k
- 收录了 139 个小红书运营相关的 Skill。不只是写作，还包括选题策划、数据分析、竞品监控。如果你是做小红书运营的，这个仓库基本能满足你的所有需求。
content-pipeline
- 链接：https://github.com/OrangeViolin/content-pipeline
- Stars：111
- 一条指令实现多平台内容发布。写一次内容，自动适配公众号、小红书、微博等不同平台的风格和格式。做自媒体矩阵的同学必备。模块 5B 会拆解这个 Skill 的设计思路。
wechat-claude-code
- 链接：https://github.com/Wechat-ggGitHub/wechat-claude-code
- Stars：216
- 通过微信直接对话 Claude Code。不需要打开终端，在微信里发消息就能让 AI 帮你做事。适合想在手机上随时随地用 AI 的同学。
avoid-ai-writing
- 链接：https://github.com/conorbronsdon/avoid-ai-writing
- Stars：887
- 去除 AI 写作痕迹的 Skill。如果你用 AI 辅助写作，但不想让人看出来是 AI 写的，这个 Skill 会帮你调整用词和句式，让文字更自然。做自媒体的都知道，太"AI味"的内容读者不爱看。
产品/需求管理
awesome-pm-skills
- 链接：https://github.com/menkesu/awesome-pm-skills
- 收录了 28 个 AI 产品管理 Skill。从 PRD 生成到竞品分析到用户调研报告，产品经理日常用到的文档基本都覆盖了。
gstack
- 链接：https://github.com/garrytan/gstack
- Y Combinator 前 CEO Garry Tan 维护的 Skill 合集。包含 CEO Review（战略决策辅助）、Code Review（代码审查）、QA 工作流（质量保障）等。质量很高，适合创业团队的产品和技术负责人参考。
UI/设计/可视化
Anthropic 官方 PPT Skill
- Anthropic 官方出品的 PPT 创建/编辑 Skill。能根据你的需求自动生成 PPT，支持调整样式和布局。做汇报、做方案、做培训材料的利器。
Anthropic 官方 Canvas Skill
- Anthropic 官方出品的视觉设计 Skill。能生成 PNG/PDF 格式的视觉设计，包括海报、信息图、流程图等。不需要设计软件，直接让 AI 帮你出图。
claude-skills
- 链接：https://github.com/alirezarezvani/claude-skills
- 收录了 232+ 个 Skill，其中包含架构图生成、UI 设计相关的。分类清晰，适合按需挑选。
学术/教育
Auto-claude-code-research-in-sleep
- 链接：https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep
- 顾名思义——你睡觉的时候让 AI 自动帮你做科研。它会自动搜索文献、整理摘要、生成研究笔记。适合研究生和科研人员，把重复的文献整理工作交给 AI。
Claude-Research-Paper-OS
- 链接：https://github.com/ARAVINDAN20/Claude-Research-Paper-OS
- 5 阶段论文生产线：选题 → 文献综述 → 实验 → 写作 → 排版。每个阶段都有对应的 Skill 自动化处理。写毕业论文的同学可以试试。
安全/逆向
Anthropic-Cybersecurity-Skills
- 链接：https://github.com/mukul975/Anthropic-Cybersecurity-Skills
- 收录了 734 个网络安全相关的 Skill。渗透测试、漏洞扫描、安全审计、逆向工程，覆盖面很广。适合安全从业者和对网络安全感兴趣的开发者。
开发/DevOps
Anthropic 官方 Git Skill
- Anthropic 官方出品的 Git 操作辅助 Skill。能帮你处理各种 Git 操作，包括合并冲突、分支管理等。
Anthropic 官方 Test Skill
- Anthropic 官方出品的测试生成 Skill。能根据你的代码自动生成单元测试，覆盖常见边界情况。
按学习阶段推荐资源
第一阶段：了解概念（1-2 天）
目标：知道 Skill 是什么、能做什么、怎么安装。
- 阅读本课程模块 1-2——建立基本概念，先动手做一个。
- 浏览 Anthropic Skilljar 课程的前两节——看官方怎么介绍 Skill，跟我们的课程互相印证。
- 安装一个现成的 Skill 试试——从 awesome-claude-skills 选一个你感兴趣的，clone 下来装上体验。用别人的 Skill 比自己写更有感觉。
这个阶段不要追求完美。先做一个能用的 Skill，用几天，有感觉了再看下一步。
第二阶段：动手实践（3-5 天）
目标：能独立写简单的 Skill，理解每个字段的作用。
- 完成本课程的模块 3-4——学会调试和从零写。
- 选一个附录 A 的模板改成你的版本——从最接近你需求的模板开始，改 name、description、正文。
- 用官方规范检查——把你的 SKILL.md 贴到 agentskills.io 的验证器里跑一遍，看有没有格式问题。
- 阅读 2-3 个官方 Skill 源码——从 Anthropic 官方 Skill 库挑几个看。看官方怎么写 description、怎么组织正文、怎么处理边界情况。
这个阶段的核心是从"能用"到"好用"。多看别人怎么写的，多对比自己的 Skill。
第三阶段：写出好用的 Skill（1-2 周）
目标：能设计复杂 Skill，掌握触发优化、反模式、渐进式披露等进阶技巧。
- 阅读 The Complete Guide to Building Skills for Claude——官方 33 页指南（英文 PDF），涵盖所有最佳实践。很多你在别的地方找不到的细节这里都有。
- 学习社区中的高质量 Skill——从 antigravity-awesome-skills 找 Stars 高的 Skill 学习。看别人怎么处理复杂的触发逻辑、怎么用 scripts/ 和 references/。
- 本课程模块 5A-5B——拆解高质量的 Skill，学习高级技巧。
- 不断迭代你的 Skill——在日常使用中发现问题，持续改进。用一周后你一定会发现输出太长、有时候风格跑偏、有些说法触发不到——带着这些具体问题来调。
第四阶段：精通和分享（持续）
目标：能设计复杂的多 Skill 系统，为社区贡献。
- 学习 MCP 协议——理解 Skill 和 MCP 的配合方式，设计更强大的集成方案。
- 设计 Skill 组合方案——把大任务拆成多个协作的小 Skill。比如"内容发布系统"可以拆成选题策划 + 内容生成 + 多平台适配 + 发布调度四个 Skill。
- 发布到社区——写好 README 说明使用方法，提交到 awesome-claude-code 或 awesome-claude-skills。
- 参与规范讨论——在 agentskills.io 社区参与规范演进讨论，影响 Skill 标准的发展方向。
学习资源
入门级（零基础友好）
Anthropic Skilljar 课程
- 链接：https://anthropic.skilljar.com/introduction-to-agent-skills
- Anthropic 官方的互动课程。跟看视频不一样，这个课程里有实际的练习环节——你可以在页面里直接写 Skill 并测试。适合喜欢边学边练的同学。
FreeCodeCamp 教程
- 链接：https://www.freecodecamp.org/
- 搜索 "How to Build Your Own Claude Code Skill" 可以找到。特点是手把手教你从零写一个 Skill，每一步都有截图。适合完全没接触过 Skill 的新手。文章比较长，但跟着做一遍就能上手。
本课程（你正在看的）
- 唯一的中文系统教程，从概念到实战全覆盖。如果你正在读这个页面，说明你已经找到了。
进阶级（已有基础）
The Complete Guide to Building Skills for Claude
- 链接：https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf
- Anthropic 官方出的 33 页完整指南，英文 PDF。从最基础的概念到高级的技巧全覆盖。我推荐你至少通读一遍，很多你在别的地方找不到的细节这里都有。比如 description 的最佳写法、正文的组织结构、scripts 的调用方式。
Anthropic 官方 Skill 库源码
- 链接：https://github.com/anthropics/skills
- 阅读源码是学习的最快方式。看官方怎么写 description、怎么组织正文、怎么处理边界情况，你就怎么写。
awesome-claude-code 中的 Skill 部分
高级（想深入理解原理）
Agent Skills 开放规范全文
- 链接：https://agentskills.io/specification
- 完整的技术规范文档。了解规范制定者的设计意图，写出更符合标准的 Skill。
Claude Code 完整文档
MCP 协议文档
- 链接：https://modelcontextprotocol.io/
- 理解 Skill 和 MCP 如何配合。如果你想做跟外部工具集成的复杂 Skill，这个是必读的。
扩展阅读
提示词工程（写好 Skill 的基础）
Skill 的核心是"用自然语言教 AI 做事"，这本质上就是提示词工程。写好 Skill 的前提是写好提示词。
Anthropic 提示词工程指南
Learn Prompting
- 链接：https://learnprompting.org/
- 最全面的免费提示词工程教程，从入门到高级技巧。如果你想系统地提升"用自然语言指挥 AI"的能力，这里是最好的起点。
Markdown 和 YAML 基础
Skill 的文件格式就是 Markdown + YAML，掌握基础语法能避免很多低级错误。
Markdown 官方教程
- 链接：https://www.markdownguide.org/
- Markdown 语法完整参考。确认标题、列表、代码块等写法是否正确。
YAML 在线验证器
- 链接：https://www.yamllint.com/
- 写完 SKILL.md 的 YAML 头部后粘贴进去验证，快速排查格式问题。很多时候 Skill 不生效就是因为 YAML 里有隐藏的缩进错误或特殊字符。
工具和辅助
| 工具 | 说明 | 对我有什么用 |
|---|
| Skill 格式验证器（agentskills.io） | 在线验证 SKILL.md 格式是否合规 | 写完 Skill 后跑一遍验证，快速发现格式问题 |
| Claude Code 内置诊断 | /skill 命令查看已加载的 Skill | Skill 不生效时用来排查——如果列表里没有你的 Skill，说明加载有问题 |
| YAML 在线解析器 | 搜索 "YAML validator" | 检查 YAML 前言语法是否正确 |
| Markdown 预览工具 | VS Code 内置或在线工具 | 预览 SKILL.md 的渲染效果，确认格式正确 |
常见问题排查资源
| 问题 | 排查步骤 | 参考资源 |
|---|
| Skill 不生效 | 1. 检查文件夹位置（三层） 2. 检查 name 和文件夹名一致 3. 检查 YAML 语法 4. 重启 Claude Code | 官方规范 - name 字段 |
| 触发不到 | 1. 检查 description 触发词 2. 增加同义说法 3. 检查是否跟别的 Skill 重叠 | 本课程模块 3 - description 调优 |
| 输出质量差 | 1. 增加具体的数字约束 2. 添加输出示例 3. 添加反模式 4. 控制正文长度在 200 行内 | 本课程模块 3 - 正文优化 |
| AI 忽略指令 | 1. 用编号列表代替段落 2. 用"必须""禁止"强化语气 3. 精简 Skill 长度 | 本课程模块 2 - 正文写作技巧 |
| Token 消耗过多 | 1. 精简 SKILL.md 正文 2. 把参考资料移到 references/ 3. 减少重复内容 | 本课程模块 2 - 渐进式披露 |
社区和交流
| 渠道 | 说明 | 适合什么 |
|---|
| Claude Code Discord（Anthropic 官方） | 有专门的 Skills 频道 | 遇到问题求助、分享经验、了解最新动态 |
| GitHub Discussions（官方 Skill 库） | anthropics/skills 的讨论区 | 提出功能建议、报告 Bug、讨论最佳实践 |
| Reddit r/ClaudeAI | Reddit 社区 | 看别人的使用案例、分享你的 Skill |
| 推特/X #ClaudeCode | 社交媒体讨论 | 快速了解最新玩法和社区动态 |
定期更新的资源
以下资源变化较快，建议 Star 或收藏后定期查看：
- awesome-claude-code：几乎每周都有新 Skill 加入，建议 Star 后定期浏览。
- Anthropic 官方 Skill 库：官方会不定期发布新的 Skill，值得关注。
- Agent Skills 规范：规范可能会更新，重要变更会影响 Skill 的写法。
- Claude Code 更新日志：新版本可能引入新的 Skill 功能（如 allowed-tools 就是后来加的）。
推荐博客和文章
这些是我读过的觉得对 Skill 开发特别有帮助的独立文章，不定期更新。
- Anthropic 官方博客 Skill 相关文章 (https://www.anthropic.com/blog) — Anthropic 不定期发布 Skill 相关的深度文章，质量一如既往地高。建议用 "skill" 关键词在博客里搜索，能找到不少干货。
- "Why Your Skill Isn't Triggering" — 社区里一篇专门分析 Skill 触发问题的文章。作者做了大量实验来测试什么样的 description 触发率最高，结论很有参考价值。如果你遇到了触发问题，这篇文章能帮你快速定位原因。
- YouTube "Claude Code Skill" 搜索 — YouTube 上有不少开发者分享的 Skill 制作教程视频。质量参差不齐，但有一些很好的实操演示，适合喜欢看视频学习的人。
本附录会持续更新。如果你发现好的资源没有被收录，欢迎通过课程 GitHub 仓库补充。链接失效也欢迎反馈。