用途：这是一份编写与改进 Claude Code 技能的参考指南，目标是让未来的 Claude 实例能快速发现并应用经过验证的技术、模式或工具。
主要能力与要求：技能需可发现、可浏览、可执行。核心原则是默认 Claude 已足够聪明，只补充其不具备的上下文。何时创建：技术不够直观、模式可广泛复用、自己会再次引用、他人也能受益。不要为一次性方案、已有完善文档的标准做法或项目约定创建（后者放 .claude/CLAUDE.md）。
结构：frontmatter 仅支持 name 和 description，总计不超过 1024 字符；name 只能用字母、数字、连字符，最长 64 字符，用动名词形式，避免 anthropic、claude 等保留词；description 用第三人称，以 Use when... 开头，同时包含触发条件与技能作用。文档建议分 Overview、When to Use、Quick Reference、Implementation、Common Mistakes 等部分。
CSO 与命名：description 决定未来 Claude 是否认为技能相关，需覆盖错误信息、症状、同义词、工具名等关键词；命名用动名词，如 creating-skills。
其他要点：代码示例一个优秀胜过多个平庸，需完整可运行、有注释、来自真实场景；用渐进披露与交叉引用保持简洁，SKILL.md 建议不超过 500 行，频繁加载的技能控制在 200 词内；流程图仅用于非显而易见的决策；按任务复杂度匹配自由度。限制：资料未提供除结构与规范外的具体安装命令、平台或收费信息。