用途
Example Skill 是一个示例技能,用于演示 Claude Code 插件技能(plugin skill)的结构与格式。它的定位是参考与教学,而非提供某项具体业务能力。当用户请求涉及创建或理解插件技能、需要技能模板或参考、或讨论技能开发模式时,该技能会被激活。
主要能力
该技能围绕“技能如何编写”提供说明,包括:
- 技能的定义方式:技能是模型调用的能力(model-invoked),Claude 根据任务上下文自主使用;与命令(用户调用)和智能体(由 Claude 派生)不同,技能提供的是上下文指导,由 Claude 融入其回复中。
- 技能的文件结构:必需文件为
skills/skill-name/SKILL.md(主技能定义);可选支持文件包括README.md(附加文档)、references/(参考资料,如 patterns.md)、examples/(示例文件,如 sample.md)、scripts/(辅助脚本,如 helper.sh)。 - frontmatter 字段:
name(必填,技能标识符)、description(必填,触发条件,描述 Claude 应在何时使用该技能)、version(可选,语义化版本号)、license(可选,许可证信息或引用)。 - description 的撰写方法:description 字段至关重要,它告诉 Claude 何时调用该技能。推荐模式为:
description: This skill should be used when the user asks to "specific phrase", "another phrase", mentions "keyword", or discusses topic-area.其中应包含用户可能说出的具体触发短语、表明相关性的关键词、以及技能覆盖的主题领域。 - 技能内容准则:明确目的(说明技能帮助解决什么)、何时使用(定义激活条件)、结构化指导(逻辑组织信息)、可操作指令(提供具体步骤)、示例(在有用时包含实际示例)。
- 最佳实践:让技能聚焦于单一领域;撰写能清晰表明何时激活的 description;为复杂技能在子目录中放置参考资料;测试技能是否在预期查询下激活;避免与其他技能的触发条件重叠。
使用方式
该技能由 Claude 根据任务上下文自主调用,无需用户手动执行命令。当用户提出“demonstrate skills”“show skill format”“create a skill template”等请求,或讨论技能开发模式时,技能会被激活并提供上述结构与格式指导。
适用场景
- 需要了解 Claude Code 插件技能的文件组织方式。
- 需要创建新的技能模板或参考示例。
- 需要撰写或优化技能的 description 触发条件。
- 讨论技能开发模式与最佳实践。
限制
资料未提供该技能的安装命令、版本号、许可证具体内容、收费或价格信息、平台支持范围及实际运行效果,这些内容暂未提供。