用途:为创建有效技能提供指导。当用户想新建技能或更新已有技能、以扩展 Claude 能力时使用。
主要能力:讲解技能的定义与价值,即模块化、自包含的包,用于提供专门知识、工作流和工具,使 Claude 从通用智能体变为特定领域的专业智能体。说明技能可提供的特殊工作流、工具集成、领域专长以及捆绑资源(脚本、参考资料、资产)。
核心原则:强调简洁优先,默认 Claude 已经很聪明,只补充它不具备的上下文;用简洁示例代替冗长解释。并给出自由度设置:流程脆弱时用低自由度(具体脚本、少量参数),存在多种可行方式时用高自由度(文本指令),介于两者之间用中自由度(伪代码或带参数脚本)。
技能结构:每个技能包含必需的 SKILL.md(YAML frontmatter 中的 name 与 description 必填,以及 Markdown 正文)和可选捆绑资源:scripts/(可执行代码)、references/(按需加载的文档)、assets/(用于输出的模板、图标、字体等)。不建议包含 README、安装指南等额外文档。采用渐进式披露:元数据始终在上下文,SKILL.md 正文在触发时加载,捆绑资源按需加载。SKILL.md 正文建议控制在 500 行以内,内容过多时拆分为参考文件并从 SKILL.md 引用;参考文件保持一层深度,长文件加目录。
创建流程:理解技能及具体示例;规划可复用内容;运行 scripts/init_skill.py <skill-name> --path <output-directory> 初始化技能;编辑技能(实现资源并编写 SKILL.md);运行 scripts/package_skill.py <path/to/skill-folder> 打包为可分发的 .skill 文件,可选指定输出目录,如 scripts/package_skill.py <path/to/skill-folder> ./dist;根据实际使用迭代。
限制:资料未提供脚本运行环境、依赖安装方式、版本要求、收费或平台信息;打包脚本的具体校验细节在资料中未完整给出,暂未提供。