Skill Builder 是一个用于创建 Claude Code 技能的元技能,目标是让新技能遵循成熟技能(Linear、Governance)中已验证的模式。仓库内提供 templates 模板目录、BEST-PRACTICES.md 最佳实践文档,以及 scripts/create-repo.mjs GitHub 自动化脚本。
用途:当用户想要创建、提取或构建一个新的 Claude Code 技能时使用。
主要能力:
- 引导收集基本信息,包括技能名称(简短、具描述性)、一句话描述、触发短语,以及技能解决的问题。
- 提供可复制并定制的模板,覆盖 SKILL.md、CHANGELOG.md、README.md、package.json、.claude-plugin/plugin.json、.claude-plugin/marketplace.json 和可选的 setup.mjs 安装校验脚本。
- 通过 create-repo.mjs 脚本将技能仓库发布到 GitHub,并支持指定名称、描述与 GitHub topics。
- 汇总模板化最佳实践,例如在 CHANGELOG 中记录 Lesson Learned、提供 Quick Start、在 frontmatter 中声明 allowed-tools、用反模式表对照正确做法、编写安装校验脚本等。
使用方式:
- 复制模板:cp -r templates/* /path/to/new-skill/,然后按占位符(如 {{SKILL_NAME}}、{{SKILL_TITLE}}、{{DESCRIPTION}}、{{TRIGGER_PHRASES}}、{{TOPICS}}、{{AUTHOR}}、{{DATE}})替换内容。
- 按模板优先流程建立目录结构:skills/<skill-name>/scripts、.claude-plugin、可选 templates。
- SKILL.md 建议包含 frontmatter(name、description、allowed-tools)、Quick Start、触发条件、核心模式、反模式对比、相关文档等段落。
- package.json 仅放 npm 元数据,插件清单放在 .claude-plugin/plugin.json,作为单一事实来源;plugin 与 marketplace 的 name 字段必须为 kebab-case,否则 /<skill-name> 无法调用技能。
- 用户安装流程:claude plugin marketplace add <user>/<skill-name>-claude-skill,然后 claude plugin install <skill-name>@<user>-skills。
- 发布前按检查清单核对:frontmatter 完整、Quick Start 存在、占位符已全部替换、无项目特定引用、CHANGELOG 含初始版本与 Lesson Learned、README 含安装说明、两个清单文件存在、LICENSE 为 MIT、topics 含 claude、claude-code、claude-plugin。
适用场景:从零创建 Claude Code 技能、把已有工作流提取为技能、按统一规范整理技能仓库并发布到 GitHub。
限制:资料未说明该技能对特定平台、价格或效果的额外保证;实际可用性取决于本地环境与 Claude Code 插件机制。