用途:这是一个指导如何创建有效技能(Skill)的技能。当用户想新建或更新一个扩展 Claude 能力的技能时使用。技能是模块化、自包含的包,通过提供专门知识、工作流和工具,把通用型智能体变为特定领域的专门智能体,可视为某领域的“上手引导”。
主要能力:技能可提供专门工作流(特定领域的多步流程)、工具集成(处理特定文件格式或 API 的说明)、领域专业知识(公司特有知识、schema、业务逻辑)以及捆绑资源(脚本、参考资料、资产)。
核心原则:强调简洁。上下文窗口是公共资源,只补充 Claude 尚不具备的信息;用简洁示例代替冗长解释。同时要设置合适的自由度:高自由度用文本指令,中自由度用伪代码或带参数的脚本,低自由度用具体脚本和少量参数。
技能结构:每个技能包含必需的 SKILL.md 与可选的捆绑资源。SKILL.md 含必需 YAML frontmatter(name、description)和 Markdown 正文;description 是主要触发机制,需说明技能做什么以及何时使用。可选目录包括 scripts/(可执行代码)、references/(按需载入的文档)、assets/(用于输出的模板、图标、字体等)。不应包含 README.md、INSTALLATION_GUIDE.md 等无关文档。
渐进式披露:采用三层加载——元数据始终在上下文(约 100 词)、SKILL.md 正文在触发时加载(<5k 词)、捆绑资源按需加载。SKILL.md 正文应保持精简、500 行以内,超限时拆分到独立文件并从 SKILL.md 引用。常见模式有:高层指南加引用文件、按领域或变体组织内容、条件化细节。引用应保持从 SKILL.md 出发的一层深度;超过 100 行的引用文件宜在顶部加目录。
创建流程:理解技能(结合具体示例)、规划可复用内容(脚本、参考资料、资产)、初始化技能(运行 scripts/init_skill.py <skill-name> --path <output-directory>)、编辑技能与编写 SKILL.md、打包技能(运行 scripts/package_skill.py <path/to/skill-folder>,可选 ./dist 指定输出目录)、根据真实使用迭代。脚本需实际运行测试;示例文件应删除不用的部分。
限制:资料未提供具体收费、价格、平台支持范围及效果保证等信息。