用途:skill-builder 提供创建有效技能的指导,适用于用户想要新建技能,或更新已有技能以扩展 Claude 能力时。
主要能力:说明技能是模块化、自包含的包,可为 Claude 提供专门知识、工作流与工具;讲解技能能提供专门工作流、工具集成、领域专长与捆绑资源。核心原则包括:保持简洁,只补充 Claude 尚不具备的上下文;按任务脆弱性与可变性设置合适自由度(高自由度文本指令、中自由度伪代码或带参脚本、低自由度具体脚本)。
技能结构:每个技能包含必需的 SKILL.md 与可选捆绑资源。SKILL.md 含 YAML frontmatter(name、description 必填)与 Markdown 正文;可选目录包括 scripts/(可执行代码)、references/(按需加载的文档)、assets/(输出用模板、图标、字体等)。不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档。
渐进式披露:采用三级加载——元数据始终在上下文、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> 打包(可指定输出目录,如 ./dist);根据实际使用迭代。
限制:资料未提供该技能的收费、价格、平台支持范围与效果数据;打包脚本的完整校验细节在资料中未完整给出。