Skip to content
Back to search

claude-skills-guide

SkillWorks with Claude CodeGitHub

📚 Claude Skills 开发完全指南 - 从基础到精通 | Complete guide for developing Claude Skills - from basics to mastery

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sanshao85--claude-skills-guide/badge.svg)](/listings/sanshao85--claude-skills-guide)

HTML

<a href="/listings/sanshao85--claude-skills-guide"><img src="/api/listings/sanshao85--claude-skills-guide/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 385 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 📚 Claude Skills 开发指南 / Claude Skills Development Guide
  2. <div align="center">
  3. [![GitHub stars](https://img.shields.io/github/stars/sanshao85/claude-skills-guide?style=social)](https://github.com/sanshao85/claude-skills-guide/stargazers)
  4. [![GitHub forks](https://img.shields.io/github/forks/sanshao85/claude-skills-guide?style=social)](https://github.com/sanshao85/claude-skills-guide/network/members)
  5. [![GitHub issues](https://img.shields.io/github/issues/sanshao85/claude-skills-guide)](https://github.com/sanshao85/claude-skills-guide/issues)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  7. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
  8. **🇨🇳 中文** | [🇺🇸 English](./README_EN.md)
  9. </div>
  10. > 📖 学习如何创建专业的 Claude Skills - 从基础到精通
  11. > 📖 Learn how to create professional Claude Skills - from basics to mastery
  12. ---
  13. ## 🎯 什么是 Claude Skills?
  14. **Claude Skills** 是一种标准化的能力包,将专家知识封装成文件,让 Claude 能够在特定任务上表现得更专业。
  15. ### 核心组成
  16. 每个 Skill 由三部分构成:
  17. 1. **SKILL.md** - 主要指令文件(必需)
  18. 2. **scripts/** - 可执行代码(可选)
  19. 3. **reference/** - 参考资源(可选)
  20. ### 工作原理
  21. Skills 采用**渐进式披露**机制,分三层加载:
  22. - **Level 1**: 元数据(name + description)- 始终加载,~100 tokens
  23. - **Level 2**: 指令(SKILL.md 主体)- 触发时加载,~5k tokens
  24. - **Level 3**: 资源和代码 - 按需加载
  25. 这样设计可以最大化节省 token,只在需要时才加载详细内容。
  26. ---
  27. ## 📦 本项目包含什么?
  28. ### 📖 核心文档(3 个)
  29. 1. **README.md**(本文件)- 项目介绍和快速开始
  30. 2. **Claude_Skills_开发完全指南.md** - 详细的开发教程(2500+ 行)
  31. 3. **快速参考卡片.md** - 模板和检查清单
  32. ### 🎨 官方示例(17 个 Skills)
  33. **anthropic-skills/** - Anthropic 官方 Skills 仓库,包含:
  34. **创意设计类**:
  35. - algorithmic-art - 算法艺术生成
  36. - canvas-design - 画布设计
  37. - slack-gif-creator - Slack GIF 创建
  38. **开发技术类**:
  39. - artifacts-builder - Claude.ai Artifacts 构建
  40. - mcp-builder - MCP 服务器构建
  41. - webapp-testing - Web 应用测试
  42. **企业沟通类**:
  43. - brand-guidelines - 品牌规范应用
  44. - internal-comms - 内部沟通
  45. - theme-factory - 主题工厂
  46. **文档处理类**(document-skills/):
  47. - docx - Word 文档处理
  48. - pdf - PDF 文档处理
  49. - pptx - PowerPoint 处理
  50. - xlsx - Excel 处理
  51. **元 Skills**:
  52. - skill-creator - Skill 创建指南
  53. - template-skill - Skill 模板
  54. **其他示例**:
  55. - claude-cookbooks/skills/ - 包含 3 个财务相关示例
  56. ---
  57. ## 🚀 快速开始(5 分钟)
  58. ### 第 1 步:查看一个简单的 Skill
  59. ```bash
  60. # 查看最简单的模板
  61. cat anthropic-skills/template-skill/SKILL.md
  62. ```
  63. 一个最基本的 Skill 就是这样:
  64. ```markdown
  65. ---
  66. name: my-skill
  67. description: 描述这个 Skill 做什么以及何时使用
  68. ---
  69. # My Skill
  70. [在这里添加你的指令...]
  71. ## 示例
  72. - 示例 1
  73. - 示例 2
  74. ```
  75. ### 第 2 步:创建你的第一个 Skill
  76. ```bash
  77. # 创建目录
  78. mkdir my-first-skill
  79. cd my-first-skill
  80. # 创建 SKILL.md
  81. cat > SKILL.md << 'EOF'
  82. ---
  83. name: greeting-expert
  84. description: 专业的问候语生成专家,根据时间和场合生成合适的问候语
  85. ---
  86. # 问候语专家
  87. 你是一个问候语生成专家。根据用户提供的信息生成合适的问候语。
  88. ## 指令
  89. 1. 询问用户需要什么类型的问候语
  90. 2. 考虑时间、场合、对象等因素
  91. 3. 生成 3-5 个不同风格的问候语选项
  92. 4. 解释每个问候语适合的场景
  93. ## 示例
  94. 用户:"我需要一个早上的商务问候语"
  95. 回复:
  96. 1. "早上好!祝您今天工作顺利!"(正式)
  97. 2. "早安!新的一天,新的开始!"(积极)
  98. 3. "您好!很高兴在这个美好的早晨见到您!"(热情)
  99. EOF
  100. ```
  101. ### 第 3 步:使用你的 Skill
  102. 在 Claude.ai、Claude Code 或 API 中上传这个 Skill 文件夹,然后就可以使用了!
  103. ---
  104. ## 📖 学习路径
  105. ### 🎯 初学者(1-2 小时)
  106. **目标**:理解 Skills 基础,创建简单 Skill
  107. 1. **阅读本 README**(15 分钟)
  108. 2. **查看 template-skill**(15 分钟)
  109. ```bash
  110. cat anthropic-skills/template-skill/SKILL.md
  111. ```
  112. 3. **查看 2-3 个简单示例**(30 分钟)
  113. - brand-guidelines
  114. - internal-comms
  115. 4. **创建你的第一个 Skill**(30 分钟)
  116. - 只包含 SKILL.md
  117. - 不需要脚本
  118. ### 🎓 进阶者(3-5 小时)
  119. **目标**:掌握最佳实践,创建包含脚本的 Skill
  120. 1. **阅读 Claude_Skills_开发完全指南.md 核心章节**(2 小时)
  121. - 第 5 章:SKILL.md 编写
  122. - 第 6 章:Scripts 开发
  123. - 第 8 章:最佳实践
  124. 2. **研究复杂示例**(1 小时)
  125. - mcp-builder
  126. - webapp-testing
  127. - document-skills
  128. 3. **创建包含脚本的 Skill**(2 小时)
  129. ### 🚀 高级者(5+ 小时)
  130. **目标**:精通 Skills 开发,创建生产级 Skill
  131. 1. **完整阅读 Claude_Skills_开发完全指南.md**(3 小时)
  132. 2. **研究所有官方示例**(2 小时)
  133. 3. **创建生产级 Skill**(多次迭代)
  134. ---
  135. ## 💡 核心要点
  136. ### ✅ 好的 Skill 应该:
  137. - **简洁** - 只教 Claude 不知道的东西
  138. - **精准** - description 要准确描述使用场景
  139. - **结构化** - 使用清晰的步骤和示例
  140. - **可测试** - 提供具体的使用示例
  141. - **适度** - SKILL.md 保持在 500 行以内
  142. ### ❌ 避免这些错误:
  143. - 过度解释 Claude 已知的基础知识
  144. - 包含会过时的时效性信息
  145. - SKILL.md 过长(超过 1000 行)
  146. - 缺少具体的使用示例
  147. - description 太模糊
  148. ---
  149. ## 📚 文档导航
  150. | 需求 | 推荐文档 |
  151. |------|---------|
  152. | **快速了解** | 本 README |
  153. | **深入学习** | Claude_Skills_开发完全指南.md |
  154. | **快速查阅** | 快速参考卡片.md |
  155. | **查看示例** | anthropic-skills/ |
  156. ---
  157. ## 🎨 官方示例索引
  158. ### 按复杂度
  159. **简单**(只有 SKILL.md):
  160. - template-skill
  161. - brand-guidelines
  162. - internal-comms
  163. **中等**(包含 reference/):
  164. - skill-creator
  165. - mcp-builder
  166. **复杂**(包含 scripts/):
  167. - webapp-testing
  168. - slack-gif-creator
  169. - document-skills
  170. ### 按用途
  171. **学习参考**:
  172. - template-skill - 最基本的模板
  173. - skill-creator - 如何创建 Skill
  174. **创意设计**:
  175. - algorithmic-art
  176. - canvas-design
  177. - theme-factory
  178. **开发工具**:
  179. - artifacts-builder
  180. - mcp-builder
  181. - webapp-testing
  182. **文档处理**:
  183. - document-skills/docx
  184. - document-skills/pdf
  185. - document-skills/pptx
  186. - document-skills/xlsx
  187. ---
  188. ## 📞 参考资源
  189. ### 官方文档
  190. - [Skills 概览](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview)
  191. - [最佳实践](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices)
  192. - [快速开始](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/quickstart)
  193. ### 官方仓库
  194. - [anthropics/skills](https://github.com/anthropics/skills) - 官方示例 Skills
  195. - [anthropics/claude-cookbooks](https://github.com/anthropics/claude-cookbooks) - 官方教程
  196. ---
  197. ## ✅ 创建 Skill 检查清单
  198. ### 开始前
  199. - [ ] 明确 Skill 的目标和使用场景
  200. - [ ] 确定是否需要 scripts 和 reference
  201. - [ ] 准备好 2-3 个使用示例
  202. ### 创建时
  203. - [ ] 编写清晰的 name(小写,连字符)
  204. - [ ] 编写精准的 description(包含使用场景)
  205. - [ ] 提供具体的使用示例
  206. - [ ] 保持 SKILL.md 简洁(< 500 行)
  207. - [ ] 使用结构化的指令格式
  208. ### 完成后
  209. - [ ] 在不同场景下测试
  210. - [ ] 检查是否有不必要的内容
  211. - [ ] 确保示例清晰易懂
  212. - [ ] 添加必要的注释
  213. ---
  214. ## 🎉 开始创建你的第一个 Skill!
  215. 选择一个路径开始:
  216. ### 路径 1: 查看示例
  217. ```bash
  218. # 查看最简单的模板
  219. cat anthropic-skills/template-skill/SKILL.md
  220. # 查看一个实际的 Skill
  221. cat anthropic-skills/brand-guidelines/SKILL.md
  222. ```
  223. ### 路径 2: 深入学习
  224. ```bash
  225. # 阅读完整指南
  226. open Claude_Skills_开发完全指南.md
  227. ```
  228. ### 路径 3: 立即创建
  229. ```bash
  230. # 创建你的 Skill
  231. mkdir my-skill
  232. cd my-skill
  233. # 复制模板并修改...
  234. ```
  235. ---
  236. ## 🤝 贡献 / Contributing
  237. 欢迎贡献!请查看 [贡献指南](./CONTRIBUTING.md) 了解详情。
  238. We welcome contributions! Please see [Contributing Guide](./CONTRIBUTING.md) for details.
  239. **贡献方式 / Ways to contribute:**
  240. - 🐛 报告问题 / Report bugs
  241. - 💡 提出建议 / Suggest features
  242. - 📝 改进文档 / Improve documentation
  243. - 🎨 分享你的 Skill / Share your skills
  244. - 🌍 翻译文档 / Translate docs
  245. ---
  246. ## 📄 许可证 / License
  247. 本项目采用 [MIT License](./LICENSE) 开源。
  248. This project is licensed under the [MIT License](./LICENSE).
  249. ---
  250. ## 🙏 致谢 / Acknowledgments
  251. - 感谢 [Anthropic](https://www.anthropic.com/) 提供的官方文档和示例
  252. - 感谢所有贡献者的支持和帮助
  253. - 特别感谢 Claude Skills 社区
  254. Thanks to:
  255. - [Anthropic](https://www.anthropic.com/) for official documentation and examples
  256. - All contributors for their support and help
  257. - Claude Skills community
  258. ---
  259. ## ⭐ Star History
  260. 如果这个项目对你有帮助,请给它一个 Star!⭐
  261. If this project helps you, please give it a star! ⭐
  262. [![Star History Chart](https://api.star-history.com/svg?repos=sanshao85/claude-skills-guide&type=Date)](https://star-history.com/#sanshao85/claude-skills-guide&Date)
  263. ---
  264. **祝你 Skill 开发愉快! / Happy Skill Development!** 🚀

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.