mcpField
S
skill-creator

skill-creator

github.com/heyvhuangAgent 工作流33852 次安装30 周前更新
代码仓库

关于 skill-creator

skill-creator 为 Agent 技能作者提供构建指南和工具，涵盖触发条件、文件化工作流及验证打包流程。

主要功能

  1. 01规划触发条件与输入输出
  2. 02按需加载分层文档
  3. 03复用脚本与模板
  4. 04验证并打包技能

适用场景

  1. 01设计新的 Agent 技能
  2. 02添加确定性辅助脚本
  3. 03检查并打包技能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/heyvhuang/ship-faster --skill skill-creator

安装后在 Claude Code 中输入/skill-creator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

output-patterns.md
workflows.md
references/
legacy-skill-creator.md
skill-design-principles.md
scripts/
generate_manifest.py
init_skill.py
package_skill.py
quick_validate.py
skill_lint.py
sync_catalog.py

详细介绍

技能创建器

构建表现如同“资深工程师迷你版”的技能：能够正确触发、确定性地运行，并在磁盘上留下可恢复的产物。

好的技能应有的样子（Ship Faster 标准）

  • SKILL.md：简短且易于触发（路由 + 安全 + 输入/输出 + 输出约定）。避免在这里写冗长的教程。
  • references/：仅在需要时加载的深入文档（渐进式披露）。从 SKILL.md 直接链接到这些文档。
  • scripts/：用于重复或脆弱工作的确定性辅助脚本（优先采用这种方式，而不是在聊天中重写代码）。
  • assets/：要复制的模板或文件（不用于加载到上下文中）。

深入指南：

创建流程（推荐）

  1. 收集触发示例（应该激活技能的真实用户短语）。
  2. 定义输入/输出约定（仅指定路径）+ 必需产物：
    • 技能会读取哪些文件？
    • 必须写入哪些文件（计划、证据、摘要）？
  3. 优先实现可复用资源：
    • 添加 scripts/，用于执行确定性步骤
    • 添加 references/，用于存放较长的文档
    • 添加 assets/，用于存放模板/样板文件
  4. 最后编写 SKILL.md：
    • frontmatter 中的 description 应包含触发短语
    • 正文应简短，并链接到上述资源
  5. 验证 + 打包（可选），使用下面的脚本。

脚本

所有脚本都位于此技能文件夹中的 scripts/ 目录下。

初始化新的技能文件夹
python scripts/init_skill.py <skill-name> --path <output-directory>
验证技能（frontmatter + 基本约定）
python scripts/quick_validate.py /path/to/<skill-name>
同步目录/资源（清单、skills-map、文档目录）
python scripts/sync_catalog.py
检查技能（兼容性 + 质量门禁）
python scripts/skill_lint.py --check-generated
将技能打包为可分发的 .skill zip 文件（可选）
python scripts/package_skill.py /path/to/<skill-name> [output-directory]

Ship Faster 贡献者须知

  • 优先使用前缀命名：workflow-、tool-、review-、mcp-、skill-、publish-。
  • 对副作用进行把关：先编写计划，征求明确确认，然后执行，最后验证。
  • 如果添加/移除技能，请更新目录：skills/manifest.json。

Claude Code：斜杠命令已并入技能

Claude Code 现在将自定义斜杠命令和技能视为同一概念：

  • .claude/commands/<name>.md 和 .claude/skills/<name>/SKILL.md 都会创建 /<name>
  • 现有的 .claude/commands/ 文件仍可正常使用（无需迁移）
  • 今后优先创建技能，以便打包 references/、scripts/ 并使用子 Agent

实用的 frontmatter 配置项（Claude Code）：

  • disable-model-invocation: true - 仅用户可以调用（适用于有副作用的工作流）
  • user-invocable: false - 对用户隐藏；作为仅供 Claude 使用的后台知识
  • context: fork + agent: Explore|Plan|... - 在子 Agent 中运行技能（适用于研究）
  • allowed-tools - 在此技能处于活动状态时限制可用工具

已归档的完整指南

此技能的旧版（长篇）版本保存在：

评论

支持 Markdown