Claude Code 技能开发指南
指导开发、组织和验证 Claude Code 插件技能。
内容主要提供技能编写与验证指导，未发现恶意行为、凭证窃取、隐蔽外传或破坏性默认操作；但未明确用户确认、敏感数据处理、外部副作用、回滚和依赖安全，因此扣分。
结构、触发描述和验证清单较一致，且给出目录、命令和失败检查项；但未提供可执行测试结果、异常输入处理或可诊断失败输出。按静态审查上限取7分。
明确面向 Claude Code 插件技能开发，并列出具体触发短语和适用流程；但非适用范围、中文支持、不同环境兼容性及中国大陆网络可达性未说明，因此扣分。
信息架构清晰，涵盖渐进式披露、目录约定、示例、版本字段和资源引用；但选定技能未声明许可证、变更记录、维护责任或明确更新路径，且部分示例依赖外部同目录内容，故扣分。
提供从需求理解、资源规划、结构创建、编辑、验证到迭代的可操作流程，能够覆盖核心任务；但没有本技能关键路径的实际输出或执行证据，且部分建议可能需要额外仓库上下文，按静态上限取6分。
源文件本身可审计，包含明确规则、清单和命令示例；但没有针对该技能的测试套件、CI覆盖或第三方执行证据，事实与建议也未系统区分，故取4分。
- 该评估仅基于提供的静态文件，未执行命令、测试或安装流程。
- 技能未明确许可证、维护责任、更新机制、回滚策略及敏感数据处理边界。
- 部分插件行为、目录内容和验证结果依赖未纳入选定技能证据的仓库上下文。
- 未说明中文交互或中国大陆网络环境下的适配性。
它能做什么 & 适用场景
该技能面向希望创建或改进 Claude Code 插件技能的开发者。它说明 SKILL.md 的元数据、正文结构及可选脚本、参考资料和资源目录。内容重点是触发描述、渐进式披露、祈使式写作和验证流程。它适合开发插件技能，不是通用的软件开发或代码生成技能。
提供创建技能的分步流程：了解使用场景、规划可复用资源、创建插件技能目录、编辑 SKILL.md、添加 references、examples 和 scripts，并检查结构、前置元数据、触发短语、写作风格、引用文件和脚本。文中给出用于创建目录和文件的 mkdir、touch 命令，以及使用 cc --plugin-dir 本地测试插件的方法。它还建议请求 skill-reviewer agent 检查技能质量。
- 插件开发者需要从零创建一个包含 SKILL.md 的新技能时。
- 团队需要为现有技能补充 scripts、references 或 examples 时。
- 维护者希望改进技能描述，使其响应更准确的用户触发语句时。
- 开发者需要将过长的技能内容拆分为渐进加载的参考资料时。
- 维护者准备验证技能结构、写作格式和本地加载行为时。
优缺点一览
- 覆盖从需求理解到迭代改进的完整技能开发流程。
- 明确规定触发描述、祈使式正文和渐进式披露等质量标准。
- 提供结构、验证、引用文件和本地测试方面的具体检查项。
- 针对 Claude Code 插件目录和自动发现机制进行了说明。
- 内容主要针对 Claude Code 插件，迁移到其他平台需要调整目录、命令和平台说明。
- 没有提供独立技能的安装流程或打包命令。
- 示例中的 scripts、references 和 examples 是方法说明，不代表该技能随附这些资源。
- 仓库许可证在提供的资料中标为 unknown。
如何安装
README 只记录 Claude Code 整体的安装方式，包括 macOS/Linux 的 curl 安装脚本、Homebrew、Windows PowerShell 和 WinGet；npm 安装已标为弃用。它没有提供单独安装该技能的命令。该技能位于 plugins/plugin-dev/skills/skill-development/SKILL.md，应作为相应 Claude Code 插件仓库的一部分使用。
如何使用
在 Claude Code 中提出具体请求，例如“create a skill”“add a skill to plugin”“improve skill description”或“organize skill content”。创建插件技能时，按指南建立 plugin-name/skills/skill-name/ 目录并添加 SKILL.md；本地测试插件时，指南给出 cc --plugin-dir /path/to/plugin。