用途:为创建或更新扩展 Claude 能力的技能(Skill)提供指导。技能是模块化、自包含的包,通过专门知识、工作流和工具把通用型 Claude 转变为特定领域或任务的专门代理。
主要能力与原则:强调简洁,因为上下文窗口是与系统提示、对话历史、其他技能元数据共享的公共资源;只补充 Claude 本身不具备的上下文,优先用简洁示例而非冗长解释。自由度需与任务脆弱性和可变性匹配:高自由度用文本指令,适用于多种方法均有效或依赖上下文判断的情形;中自由度用伪代码或带参数脚本,适用于存在偏好模式但允许变化的情形;低自由度用具体脚本、少量参数,适用于操作脆弱、易错且必须遵循特定顺序的情形。
技能结构:每个技能包含必需的 SKILL.md 与可选捆绑资源。SKILL.md 由 YAML frontmatter(name、description)和 Markdown 正文组成,frontmatter 是 Claude 判断何时使用技能的唯一字段。可选资源包括 scripts/(可执行代码,用于确定性可靠性或反复重写的任务)、references/(按需加载的文档,如数据库模式、API 文档、领域知识、公司政策、详细工作流指南)、assets/(不加载进上下文而用于产出的文件,如模板、图标、字体、样板代码)。不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等无关文档。
渐进式披露:采用三级加载——元数据(name+description)始终在上下文中;SKILL.md 正文在触发时加载(建议低于 500 行);捆绑资源按需加载。支持高层指南加引用、按领域组织、条件细节等模式。引用应保持一层深度,较长的引用文件建议在顶部加目录。
创建流程:理解技能及具体示例;规划可复用内容(脚本、引用、资产);运行初始化脚本:scripts/init_skill.py <skill-name> --path <output-directory>;编辑技能,编写 SKILL.md 与资源,脚本需实际运行测试,删除不需要的示例文件,正文使用祈使/不定式形式,frontmatter 不加其他字段;打包:scripts/package_skill.py <path/to/skill-folder>,可选指定输出目录 scripts/package_skill.py <path/to/skill-folder> ./dist,打包脚本会自动校验 frontmatter 格式、必填字段、命名约定与目录结构等;最后根据真实使用迭代。
适用场景:需要把多步专业流程、工具集成、领域知识或重复性任务打包为可复用技能时。限制:资料未提供收费、价格、平台支持范围与执行环境等具体信息,暂未提供。