用途：指导如何设计和编写 Claude Code 技能（skills），内容基于 Anthropic 内部生产环境运行数百个技能的经验总结。
主要能力：
- 技能分类：将技能归入 9 类，包括库与 API 参考、产品验证、数据获取与分析、业务自动化、脚手架与模板、代码质量与审查、CI/CD 与部署、运行手册、基础设施运维。最佳技能应清晰归入单一类别。
- 编写技巧：不要陈述显而易见的内容，聚焦于纠正 Claude 默认思维；建立 gotchas 章节，从常见失败点迭代积累；利用文件系统与渐进式披露，SKILL.md 作为约 30 行的枢纽，其他文件按需读取；避免过度脚本化，提供信息与灵活性；description 字段面向模型，应写成触发条件而非摘要；考虑首次运行的设置，用 config.json 存储配置；使用 ${CLAUDE_PLUGIN_DATA} 持久化数据；提供辅助脚本而非仅文字说明；支持按需钩子（如 /careful 阻止危险命令，/freeze 限制编辑范围）。
- 分发策略：可签入仓库（.claude/skills/）或通过插件市场分发，市场适合规模化，建议先在沙盒文件夹中孵化，获得关注后再通过 PR 提升。
- 度量与组合：用 PreToolUse 钩子记录技能使用情况，发现热门或触发不足的技能；可在技能中引用其他技能名称，Claude 会调用已安装的技能。
使用方式：技能是一个文件夹而非单个 markdown 文件，SKILL.md 作为枢纽，其他文件按需读取。description 字段用于模型判断是否触发。设置信息存于 config.json，数据存于 ${CLAUDE_PLUGIN_DATA}。
适用场景：团队构建和维护 Claude Code 技能库，需要统一编写规范、提升技能质量与可维护性时。
限制：原生依赖管理尚未内置；技能市场需人工策展，避免冗余或低质技能；部分实践依赖具体钩子机制，需在支持的环境中运行。