Claude Code 插件技能开发指南
帮助开发者为 Claude Code 插件设计、编写、组织并验证 SKILL.md 技能。
技能本身主要提供文档和目录指导，未见恶意行为、凭证窃取或隐蔽外传；但建议创建并测试可执行脚本，未规定最小权限、用户确认、敏感数据处理、依赖安全、外部副作用或回滚机制，因此扣分。
流程分步骤且包含结构、引用、脚本和触发词检查，失败项也有一定可诊断性；但未提供可执行的验证实现，示例和引用资源的实际存在与可运行性无法由本文件确认，且静态审查不能证明关键路径，因此限制在10分以下并扣分。
前置描述给出较具体的触发短语，正文覆盖创建、改进、组织和测试技能等场景；但未明确非适用范围、输入输出契约、误触发边界、版本兼容性或中文使用支持，环境适配证据有限，因此扣分。
信息架构、渐进式披露、目录约定、命名和版本字段说明较完整，并要求引用资源、示例、限制和测试；但缺少该技能自身的维护责任人、变更记录、更新路径及完整依赖/安装说明，部分质量声明依赖未提供的其他文件，故扣分。
内容提供了可直接照做的技能创建流程、目录模板、触发描述规则和验证清单，能够覆盖核心任务；但没有本技能产出的代表性结果、真实使用反馈或静态可验证的成功案例，输出仍需人工实现和审查，因此按静态上限给分。
SKILL.md及其引用的原始参考文件是可审计的一手材料，且包含明确检查项；但没有独立复现记录、提交测试套件覆盖关键路径或第三方 corroboration，文件中的“优秀示例”和效果判断主要是作者陈述，因此不超过静态上限。
- 未执行任何命令或测试；引用的 references/、examples/、scripts/及其可运行性未在本次证据中逐项核验。
- 该技能指导创建可执行脚本和调用外部工具，但未提供权限边界、用户确认、敏感数据或回滚规范。
- 未说明中文语言行为或中国大陆网络环境适配；若工作流依赖海外文档或服务，需另行验证可达性。
- README明确提醒插件可能包含未经Anthropic控制或验证的MCP服务器、文件和软件；官方来源不等于该技能的执行安全或效果保证。
它能做什么 & 适用场景
这是 anthropics/claude-plugins-official 仓库中 plugin-dev 插件的 skill-development 技能，专门指导如何创建或改进 Claude Code 插件技能。它覆盖技能目录结构、YAML frontmatter、触发描述、渐进式披露，以及 scripts、references 和 examples 等资源的组织方式。技能还提供从理解用例到创建、编辑、验证、测试和迭代的完整流程。其内容面向 Claude Code 插件开发，包含插件目录和本地测试方式。
指导创建或修改包含 SKILL.md 的技能目录；设计 name 和 description frontmatter；规划并组织 scripts、references、examples 和 assets；编写 1,500–2,000 字左右的精简技能正文；使用第三人称触发描述和祈使式正文；检查结构、触发短语、写作风格、引用文件、示例和脚本；通过 cc --plugin-dir /path/to/plugin 进行本地插件测试；根据实际使用结果迭代技能。它本身不声明会自动运行验证脚本、调用 MCP 服务或生成文件。
- 希望为 Claude Code 插件新增技能的开发者，可按流程确定用例、资源和目录结构。
- 需要改善技能触发条件的作者，可重写包含具体用户表达的 description。
- 技能正文过长或上下文占用过高的维护者，可将详细模式、API 文档和边缘情况移入 references/。
- 需要检查技能是否能被正确加载的插件开发者，可验证 frontmatter、目录结构并使用 `cc --plugin-dir` 本地测试。
优缺点一览
- 提供从用例分析到测试迭代的完整技能开发流程。
- 明确规定 frontmatter、触发短语、祈使式写作和渐进式披露要求。
- 覆盖插件技能常见的 scripts、references、examples 和 assets 组织方式。
- 给出结构、内容质量和测试验证清单。
- 内容主要针对 Claude Code 插件，迁移到其他 Agent Skills 客户端需要调整插件结构和测试命令。
- 源材料没有证明该技能附带可直接执行的自动化验证工具或完整测试套件。
- README 没有提供 plugin-dev 的确切 marketplace 安装标识。
如何安装
该技能属于 anthropics/claude-plugins-official 的插件集合。README 说明可在 Claude Code 中运行 /plugin install {plugin-name}@claude-plugins-official，或通过 /plugin > Discover 浏览安装；源材料没有给出 plugin-dev 的确切安装名称。仓库采用 Apache-2.0 许可证。
如何使用
在 Claude Code 中提出具体请求，例如“create a skill”“add a skill to plugin”“improve skill description”或“organize skill content”。开发本地插件时，可运行 cc --plugin-dir /path/to/plugin，然后提出应触发该技能的问题并检查加载结果。