---
title: "参考资源"
wiki: skills
category: "最佳实践"
slug: D-参考资源
url: https://learnagent.wiki/skills/cards/D-参考资源
tags: ["参考资源", "Skill", "生态", "延伸阅读"]
last_updated: 2026-04-11
reading_time: 14
---

> > 附录 D：参考资源

# 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 库

1. **先搜后写**：写新 Skill 前先在这些库里搜一下，可能已经有人写了类似的。
2. **学习写法**：看别人的 Skill 怎么写 description、怎么组织步骤、怎么处理边界情况。
3. **直接安装**：大部分 Skill clone 下来放到 `.claude/skills/` 目录就能用。
4. **改造复用**：找到接近需求的 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/` |

### 查看和学习方法

```bash
# 查看 avoid-ai-writing 的完整规则表
cat .claude/skills/avoid-ai-writing/SKILL.md

# 查看 content-pipeline 的工作流编排
cat .claude/skills/content-pipeline/SKILL.md | head -200

# 查看 content-pipeline 的 references 拆分
ls .claude/skills/content-pipeline/references/

# 查看 xiaohongshu-skills 的分类结构
ls .claude/skills/xiaohongshu-skills/skills/

# 查看单个子 Skill 的设计
cat .claude/skills/xiaohongshu-skills/skills/01-内容创作/title-writing/SKILL.md

# 查看 ui-ux-pro-max 的优先级分层设计
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. **阅读本课程模块 1-2**——建立基本概念，先动手做一个。
2. **浏览 Anthropic Skilljar 课程的前两节**——看官方怎么介绍 Skill，跟我们的课程互相印证。
3. **安装一个现成的 Skill 试试**——从 awesome-claude-skills 选一个你感兴趣的，clone 下来装上体验。用别人的 Skill 比自己写更有感觉。

这个阶段不要追求完美。先做一个能用的 Skill，用几天，有感觉了再看下一步。

### 第二阶段：动手实践（3-5 天）

目标：能独立写简单的 Skill，理解每个字段的作用。

1. **完成本课程的模块 3-4**——学会调试和从零写。
2. **选一个附录 A 的模板改成你的版本**——从最接近你需求的模板开始，改 name、description、正文。
3. **用官方规范检查**——把你的 SKILL.md 贴到 agentskills.io 的验证器里跑一遍，看有没有格式问题。
4. **阅读 2-3 个官方 Skill 源码**——从 Anthropic 官方 Skill 库挑几个看。看官方怎么写 description、怎么组织正文、怎么处理边界情况。

这个阶段的核心是从"能用"到"好用"。多看别人怎么写的，多对比自己的 Skill。

### 第三阶段：写出好用的 Skill（1-2 周）

目标：能设计复杂 Skill，掌握触发优化、反模式、渐进式披露等进阶技巧。

1. **阅读 The Complete Guide to Building Skills for Claude**——官方 33 页指南（英文 PDF），涵盖所有最佳实践。很多你在别的地方找不到的细节这里都有。
2. **学习社区中的高质量 Skill**——从 antigravity-awesome-skills 找 Stars 高的 Skill 学习。看别人怎么处理复杂的触发逻辑、怎么用 scripts/ 和 references/。
3. **本课程模块 5A-5B**——拆解高质量的 Skill，学习高级技巧。
4. **不断迭代你的 Skill**——在日常使用中发现问题，持续改进。用一周后你一定会发现输出太长、有时候风格跑偏、有些说法触发不到——带着这些具体问题来调。

### 第四阶段：精通和分享（持续）

目标：能设计复杂的多 Skill 系统，为社区贡献。

1. **学习 MCP 协议**——理解 Skill 和 MCP 的配合方式，设计更强大的集成方案。
2. **设计 Skill 组合方案**——把大任务拆成多个协作的小 Skill。比如"内容发布系统"可以拆成选题策划 + 内容生成 + 多平台适配 + 发布调度四个 Skill。
3. **发布到社区**——写好 README 说明使用方法，提交到 awesome-claude-code 或 awesome-claude-skills。
4. **参与规范讨论**——在 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 部分**
- 链接：https://github.com/hesreallyhim/awesome-claude-code
- 社区精选 Skill 列表。找到高质量的第三方 Skill，学习不同的设计模式。

### 高级（想深入理解原理）

**Agent Skills 开放规范全文**
- 链接：https://agentskills.io/specification
- 完整的技术规范文档。了解规范制定者的设计意图，写出更符合标准的 Skill。

**Claude Code 完整文档**
- 链接：https://docs.anthropic.com/en/docs/claude-code
- 理解 Skill 在 AI 系统中的完整生命周期——从扫描、匹配、加载到执行。

**MCP 协议文档**
- 链接：https://modelcontextprotocol.io/
- 理解 Skill 和 MCP 如何配合。如果你想做跟外部工具集成的复杂 Skill，这个是必读的。

---

## 扩展阅读

### 提示词工程（写好 Skill 的基础）

Skill 的核心是"用自然语言教 AI 做事"，这本质上就是提示词工程。写好 Skill 的前提是写好提示词。

**Anthropic 提示词工程指南**
- 链接：https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/overview
- 官方的提示词最佳实践。理解如何写出让 AI 准确理解和执行的指令。里面的"要具体不要模糊""给示例""用反模式"等技巧，直接适用于 Skill 写作。

**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 仓库补充。链接失效也欢迎反馈。*

---
*Source: https://learnagent.wiki/skills/cards/D-参考资源*
*Markdown mirror of https://learnagent.wiki, served as text/markdown for LLM ingestion.*