Claude 技能模板示例
帮助开发者理解并创建 Claude Code 插件技能模板。
该技能为希望创建、理解或设计 Claude Code 插件技能的用户提供结构、触发条件、前置字段和写作建议，目标与适用边界较清楚。由于内容主要是通用模板，未证明相较官方文档或其他模板的独特优势，也未明确不适用场景，因此扣 6 分。
文件内容内部基本一致，涵盖目录结构、frontmatter 和编写建议，但没有可执行逻辑、测试套件、验证结果、异常处理或可重复性证据；仅静态阅读可支持有限的 happy path 可信度，因此扣 13 分。
该技能仅提供文档性指导，没有脚本、外部调用、凭据处理、数据传输或破坏性默认操作，风险面较低。仍未明确权限最小化、用户确认、隔离、回滚或数据流要求，因此扣 7 分。
SKILL.md 本身是可审计的一手材料，并包含具体结构示例和字段说明；但没有第三方复现、CI、提交测试或独立佐证，静态证据覆盖有限，因此扣 10 分。
触发条件、输入主题、输出性质和技能目录示例较清楚，采用无需额外依赖；但缺少安装、兼容性、故障排查、成本和退出/禁用说明，采用时仍有显著假设，因此扣 4 分。
技能有版本 1.0.0，仓库来源、Apache-2.0 许可、Anthropic 官方所有权和仓库级自动化维护信号清楚；但该技能自身没有变更记录、响应承诺或明确更新路径，因此扣 2 分。
- 这是静态源文件审查，未执行技能或验证其触发行为。
- 不要仅依据 Anthropic 官方来源推断可靠性、安全性、测试质量或实际效果。
- 采用者仍应核对当前 Claude Code 技能规范及实际触发结果。
它能做什么 & 适用场景
这是 anthropics/claude-plugins-official 中 example-plugin 的示例技能，面向技能开发与格式理解。它说明技能如何通过 YAML frontmatter 定义名称、触发描述和版本，并介绍必需文件与可选支持目录。内容还提供有效描述的写作模式和技能开发最佳实践。它本身不执行脚本、不调用工具，也不连接外部服务。
提供一个 SKILL.md 参考模板；说明 skills/skill-name/SKILL.md 的基本结构；列出 README.md、references/、examples/ 和 scripts/ 等可选目录；解释 name、description、version 和 license frontmatter 字段；给出技能描述的触发短语写法以及聚焦范围、测试触发和避免重叠等开发建议。
- 需要创建 Claude Code 插件技能的开发者，用它了解最小目录结构和 SKILL.md 格式。
- 正在设计技能触发条件的开发者，用它参考 description 字段应包含的短语、关键词和主题。
- 需要为复杂技能规划 references、examples 或 scripts 目录的团队，用它获取组织结构示例。
- 学习 Agent Skill 开发模式的用户，用它区分技能、命令和代理的基本定位。
优缺点一览
- 提供清晰的最小技能目录结构和可选文件布局。
- 解释 frontmatter 字段及 description 触发条件的写法。
- 适合作为技能开发的入门参考模板。
- 不要求 shell、网络、文件系统或 MCP 运行时依赖。
- 仅提供参考指导，不包含可执行脚本或自动生成流程。
- 源材料未提供测试套件、平台兼容性测试或失败处理说明。
- 内容针对 Claude Code 插件技能；其他客户端的具体加载方式未被说明。
- 它是单个示例技能，不能代表仓库中其他技能的能力。
如何安装
该技能位于插件仓库的 plugins/example-plugin/skills/example-skill/。README 支持通过 Claude Code 插件系统安装插件：运行 /plugin install example-plugin@claude-plugins-official，或在 /plugin > Discover 中查找。源材料未说明单独安装该技能的命令。
如何使用
安装包含该技能的插件后，可使用类似“demonstrate skills”“show skill format”“create a skill template”的请求，或直接询问技能开发模式。SKILL.md 将这些表达列为触发条件。源材料未说明手动调用命令、参数或输出格式。