/ 目录 / 演练场 / claude-code-skill-factory
● 社区 alirezarezvani ⚡ 即开即用

claude-code-skill-factory

作者 alirezarezvani · alirezarezvani/claude-code-skill-factory

超级技能工具包:用交互式构建器快速生成生产级 Claude Skills、智能体、斜杠命令和钩子。

Skill Factory 是一套引导式构建器——Factory Guide、Skills Guide、Prompts Guide、Agents Guide、Hooks Guide——加上 /build、/validate-output、/install-skill 等斜杠命令。你描述想要什么,它就生成 SKILL.md、示例、参考资源和可以直接放入 ~/.claude/skills/ 的 ZIP 包。开箱包含 9 个生产级技能,涵盖 AWS、M365、内容研究和 CLAUDE.md 增强。

为什么要用

核心特性

实时演示

实际使用效果

claude-code-skill-factory-skill.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-code-skill-factory-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-skill-factory",
        "~/.claude/skills/claude-code-skill-factory"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-code-skill-factory-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-skill-factory",
        "~/.claude/skills/claude-code-skill-factory"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-code-skill-factory-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-skill-factory",
        "~/.claude/skills/claude-code-skill-factory"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-code-skill-factory-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-skill-factory",
        "~/.claude/skills/claude-code-skill-factory"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-code-skill-factory-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-skill-factory",
        "~/.claude/skills/claude-code-skill-factory"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-code-skill-factory-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/alirezarezvani/claude-code-skill-factory",
          "~/.claude/skills/claude-code-skill-factory"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add claude-code-skill-factory-skill -- git clone https://github.com/alirezarezvani/claude-code-skill-factory ~/.claude/skills/claude-code-skill-factory

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: claude-code-skill-factory

如何在 10 分钟内构建并打包一个新的 Claude Skill

👤 想要交付 skill,但不想手写 SKILL.md 样板代码的开发者 ⏱ ~15 min beginner

何时使用: 你心里有一套可复用的工作流,想让 Claude 把它打包成可安装的 skill。

前置条件
  • 已安装 Skill Factory — git clone https://github.com/alirezarezvani/claude-code-skill-factory ~/.claude/skills/claude-code-skill-factory
步骤
  1. 调用 /build
    /build — 我要一个 skill,用来检查 Next.js 应用的 Core Web Vitals 问题,输出 Lighthouse 风格的报告。✓ 已复制
    → Factory 提出澄清问题:触发条件、工具分类、输出格式
  2. 回答脚手架问题
    触发条件为 'audit CWV' 或检测到 Next.js 项目。输出包含截图的 markdown 报告。✓ 已复制
    → 生成带前置数据的 SKILL.md 草稿、示例用法、参考文件
  3. 验证并打包
    /validate-output✓ 已复制
    → 前置数据、目录结构、示例完整性都通过检查;生成 ZIP 包
  4. 本地安装
    /install-skill ./out/cwv-audit.zip✓ 已复制
    → Skill 出现在 ~/.claude/skills 中,被 Claude Code 自动发现

结果: 一个工作正常、已安装的 skill,在下一个匹配的提示词出现时就能触发。

注意事项
  • Skill 对无关的提示词触发过于积极 — 收紧前置数据中的 'description'——Claude 用它来决定何时加载 skill
  • SKILL.md 中的示例偏离实际行为 — /validate-output 会重新运行示例,标出不匹配的地方
搭配使用: skills-skill-2

通过 Hooks Guide 连接预提交钩子

👤 想在特定事件上自动化 Claude Code 行为的团队 ⏱ ~10 min intermediate

何时使用: 你想让某些操作在提示词提交、工具使用或会话停止时自动运行——而不是让 Claude 选择加载的 skill。

步骤
  1. 启动 Hooks Guide
    /build hook — 在 Claude 保存机密信息前,对每次 Write 工具调用运行 gitleaks✓ 已复制
    → Guide 询问选择哪个事件:PreToolUse/PostToolUse/Stop
  2. 定义匹配器和命令
    匹配 Write 工具调用,将文件内容通过 gitleaks detect 处理,检测到时阻止。✓ 已复制
    → 生成 settings.json 中的钩子块草稿,包含匹配器和命令
  3. 安装到用户设置
    /install-hook — user scope✓ 已复制
    → ~/.claude/settings.json 已更新;下一次工具调用会受到门控

结果: 一个钩子,在机密泄露写入发生前阻止它。

注意事项
  • 钩子运行太慢,导致每次工具调用都卡住 — 如果检查不需要阻止,就改到 PostToolUse
搭配使用: claude-code-owasp-skill

用研究支持的框架创作可复用的提示词包

👤 为团队构建一致的内部提示词的提示词工程师 ⏱ ~15 min beginner

何时使用: 你想让每个队友都能使用 CO-STAR / RISEN 结构化的提示词,而不用记住这些框架。

步骤
  1. 调用 Prompts Guide
    /build prompts — 5 个用于客户支持回复的预设,采用 CO-STAR 结构✓ 已复制
    → Guide 列出可用框架,询问选择哪种语气/角色偏差
  2. 审阅并导出
    作为 prompt-pack skill 导出,让整个团队都能通过 git clone 安装。✓ 已复制
    → 包含 SKILL.md、prompts/ 目录、README 的 Skill 包

结果: 可以通过一次 git clone 安装的团队共享提示词包。

搭配使用: prompt-architect-skill

组合

与其他 MCP 搭配,撬动十倍杠杆

claude-code-skill-factory-skill + prompt-architect-skill

Prompt Architect 调优单个提示词;Skill Factory 把一组提示词打包成可共享的 skill

让 prompt-architect 优化这 5 个提示词,然后 /build prompts 并导出为 skill 包。✓ 已复制
claude-code-skill-factory-skill + skills-skill-2

在构建你自己的 skill 时,用 Posit 的 skill 集合作为参考模板

给我看 Posit R-analysis skill 的结构,然后 /build 一个以它为模型的并行 Python-analysis skill。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
/build target: 'skill'|'agent'|'prompt'|'hook', description: str 创建任何新扩展的顶级入口 interactive Claude session
/validate-output path: str 在分发 skill 前 0
/install-skill zip_or_path: str, scope?: 'user'|'project' 在验证通过后 0
/install-hook hook_definition 在 Hooks Guide 生成草稿后 0
/sync-agents-md skill_path: str 跨 Cursor/Codex 发布时 0
/factory-status - 排查缺失的构建器 0

成本与限制

运行它的成本

API 配额
无——完全在 Claude Code 内部运行
每次调用 Token 数
完整构建会话需要 5k-20k tokens
费用
免费。消耗你的 Claude 订阅额度。
提示
保持构建会话的专注——果断回答问题,避免对话扩展成返工。

安全

权限、密钥、影响范围

凭据存储: 无凭据。Skill Factory 仅写入 ~/.claude/skills 和 ~/.claude/settings.json。
数据出站: 除了 Claude Code 本身外,没有出站调用。

故障排查

常见错误与修复

/build 未识别

Skill Factory 未加载。确认克隆路径,SKILL.md 必须在仓库根目录,不能在子文件夹。

验证: ls ~/.claude/skills/claude-code-skill-factory/SKILL.md
生成的 ZIP 在 /install-skill 时失败

通常是 SKILL.md 中的前置数据有拼写错误。先运行 /validate-output;它会显示确切缺失的字段。

安装后钩子没有输出

匹配器设置太严格。/factory-status 显示哪些事件在触发;在 settings.json 中扩宽匹配器。

验证: cat ~/.claude/settings.json | jq .hooks

替代方案

claude-code-skill-factory 对比其他方案

替代方案何时用它替代权衡
skills-skill-2 (Posit skills)你只想要现成的 skill,不想要一个自己构建的工厂没有脚手架,没有钩子构建器
Hand-writing SKILL.md你已经构建过几个 skill 了,知道怎么建更多控制,更慢,没有验证

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills