📚 Skill系统 全难度 📦

Claude Code Skill Factory

Claude Skills/Agents/Prompt/Hooks 批量生产线:10 个斜杠命令 + 5 个交互式引导 Agent + 9 个即装生产级 Skill(含 69 预设的 Prompt Factory),四步问答生成规范 SKILL.md 并本地安装。

📊 评分明细

📦 打包完整度
2.2 2.2 / 2.5
🎯 实用性
2.2 2.2 / 2.5
📖 文档清晰度
1.7 1.7 / 2
👥 社区影响力
1.3 1.3 / 1.5
🔗 集成度
1.3 1.3 / 1.5

🎯 适用场景

Skill系统开源免费Skill工厂Claude Code提示词工程

Claude Code Skill Factory 快速入门

「让 Claude 帮你造 Skill」——claude-code-skill-factory(alirezarezvani/claude-code-skill-factory)是一套装进 Claude Code 的生产线:10 个斜杠命令(/build skill、/build agent、/build prompt、/build hook 等)+ 5 个交互式引导 Agent,通过 4-7 个问题的问答生成带规范 YAML frontmatter 的 SKILL.md、配套实现文件与文档,/validate-output 校验后 /install-skill 一键装进本机。仓库另附 9 个即装生产级 Skill(含 69 预设的 Prompt Factory)。MIT,2026-09-23 核验:GitHub 870★ / 177 fork。

这是什么?适合谁?

Claude Code Skill Factory 解决的是「想给 Claude Code 加自定义能力,但不知道 SKILL.md 该写成什么样」的冷启动问题。它把 Anthropic 的 Skills/Agents/Hooks 规范封装成交互式问答流程:你说「我想建一个 skill」,factory-guide 引导 Agent 接管,问 4-5 个问题(用途、输入输出、是否需要脚本),然后产出完整目录——YAML frontmatter、Python 实现文件(按需)、示例数据、使用文档、可分发的 ZIP 包。

适合人群:

  • 想沉淀团队内部最佳实践为可复用 Skill 的开发者:不用从头研究 frontmatter 规范
  • 提示词工程师:Prompt Factory 的 69 个预设覆盖 15 个领域,支持 XML/Claude/ChatGPT/Gemini 四种输出格式
  • 同时用 Claude Code 和 Codex CLI 的团队:/sync-agents-md 自动把 CLAUDE.md 翻译成 AGENTS.md

不适合谁:只用网页版 Claude 的用户(整套工具链绑定 Claude Code 本地环境);想找现成领域技能库的人(那是作者另一个仓库 claude-skills,本仓库是「造技能的工厂」)。

准备工作

  • 运行环境:已安装并可用 Claude Code(macOS/Linux/Windows 均可)
  • 账号要求:Claude Code 需有效的 Anthropic 订阅或 API 额度;本工具链本身完全免费
  • 时间预算:clone 仓库 2 分钟;走完一次 /build skill 问答约 5-10 分钟
  • 前置知识:知道 Claude Code 的 Skill 是什么(SKILL.md + 可选脚本);不需要会写 YAML

快速上手

第一步:安装工具链

git clone https://github.com/alirezarezvani/claude-code-skill-factory.git
cd claude-code-skill-factory
claude

在仓库目录启动 Claude Code,.claude/commands/ 下的 10 个斜杠命令和 .claude/agents/ 下的 5 个引导 Agent 自动可用(仓库的 CLAUDE.md 已配置好引导规则)。

第二步:用问答造第一个 Skill

在 Claude Code 里输入:

/build skill

skills-guide 会依次问:① 这个 Skill 做什么?② 触发时机?③ 输入输出是什么?④ 需要附 Python/Shell 脚本吗?回答完即产出完整 Skill 目录。

第三步:校验并安装

/validate-output    # 校验 frontmatter 规范 + 自动打 ZIP 包
/install-skill      # 安装到 ~/.claude/skills/

第四步:试试现成的 Prompt Factory(可选)

cp -r generated-skills/prompt-factory ~/.claude/skills/

然后对 Claude 说「I need a prompt for a Senior DevOps Engineer」,按提示选输出格式,得到一份跨模型可用的 mega-prompt。

预期产出:一个可直接调用的本地 Skill(或 69 预设之一的角色提示词),SKILL.md 符合官方格式、含示例与文档。

常见踩坑

  1. 在错误的目录启动 Claude Code:斜杠命令和引导 Agent 依赖仓库内 .claude/ 目录,必须在 clone 下来的仓库根目录启动,装到全局后才会跟着走。
  2. 生成的 Skill 不触发:description 写得含糊时 Claude 判断不了何时加载——问答环节把「什么时候用我」说具体(触发词、场景),生成后再手补也行。
  3. /validate-output 报 frontmatter 错误:多为 YAML 冒号后缺空格或字段名拼错(如把 description 写成 desc),按报错行号修即可;官方模板 documentation/templates/SKILLS_FACTORY_PROMPT.md 是格式权威。
  4. Windows 路径问题:cp -r 等 bash 命令在 Windows 下用 Git Bash / WSL 执行;~/.claude/skills/ 在 Windows 是 C:\Users\<你>\.claude\skills\。
  5. 仓库双分支混淆:README 内部链接指向 dev 分支的文件,clone 默认拿到 main 分支——内容大体一致,但个别文件路径可能不同,以本地实际目录为准。
  6. 把它当技能库用:本仓库只有 9 个示例 Skill,37+ 个领域技能在作者的 claude-skills 仓库,别在这儿找不到就放弃。

常见问题 FAQ

Q1:生成的 Skill 归谁?能商用吗?

A:仓库 MIT 协议,README 明确「用模板生成的技能归你自由使用」。

Q2:能生成 Claude Code 的 subagent 吗?

A:能,/build agent 走 agents-guide 问答,产出带 name/description/tools/model 等 YAML 的 Agent 定义,支持 MCP 集成与自动调用配置。

Q3:和直接让 Claude 写 SKILL.md 有什么区别?

A:区别在规范约束:factory 的模板链会把 frontmatter 字段、文件结构、校验流程固化进生成过程,裸对话生成容易漏字段或格式漂移;/validate-output 提供二次兜底。

Q4:支持 Codex CLI 吗?

A:间接支持——/sync-agents-md 生成 Codex CLI 可读的 AGENTS.md,/codex-exec 可在 Claude Code 里调 Codex CLI 执行任务,做跨工具协作。

Q5:Hooks 工厂安全吗?

A:hooks-guide 生成前跑安全检查(工具调用检测、静默失败检测、禁止破坏性操作),支持 SessionStart/PostToolUse 等 7 种事件类型,Python/JS/Rust/Go 四种语言的格式化模板。

权限、安全、成本与限制

  • 许可:仓库 MIT(LICENSE 文件);生成物归使用者。
  • 安全:全部本地运行,不回传任何数据;Hook Factory 内置安装前安全检查。
  • 成本:工具链免费,成本只在 Claude Code 的模型调用侧(一次问答构建约几万 token 上下文)。
  • 限制:绑定 Claude Code 生态;问答式生成的质量依赖你的回答具体度;作者个人维护,v1.4.0(2025-10)后迭代放缓(最近提交 2025-11-12);本文基于官方 README 撰写,未逐个实测全部 10 个命令。

小技巧

  1. 先用 /factory-status 看四个工厂(skills/agents/prompts/hooks)的状态,再选入口,避免问错工厂重来一遍。
  2. 造 Skill 前先翻 claude-skills-examples/ 里的 3 个参考实现,照着描述你的需求,问答答案会更准。
  3. Prompt Factory 选输出格式时按目标模型选(Claude 选 Claude 格式),跨模型复用会损失格式优化。
  4. 生成的 Skill 先在一个测试项目里跑两轮再分发 ZIP,触发条件往往需要微调一次。
  5. 团队协作时把 /sync-agents-md 加进工作流,Codex 用户和 Claude 用户共享同一份规范文档。

进阶学习方向

  • Skill 规范本体:Anthropic 官方 skills 文档(docs.claude.com 的 agent-skills 章节)是 frontmatter 与触发机制的权威来源,factory 模板只是它的工程化封装。
  • Hooks 深水区:generated-skills/hook-factory/(92 KB)是最大的示例 Skill,7 种事件 × 4 种语言模板,读懂它等于读懂 Claude Code 自动化全貌。
  • 四件套组合拳:Skill Factory(造技能)→ claude-code-tresor(即用工作流工具)→ claude-skills(领域技能库)是作者设计的三层生态,按需取用。
  • Slash Command 三模式:documentation/templates/MASTER_SLASH_COMMANDS_PROMPT.md 讲解 Anthropic 官方的 Simple/Multi-Phase/Agent-Style 三种命令模式,自定义命令进阶必读。

参考链接

📊 评分与标签

评分说明

评分依据可追溯至公开来源。

总分 8.7/10 · P_优选

📊 可观测社区指标(采集日期:2026-09-23)

  • GitHub: alirezarezvani/claude-code-skill-factory ★870, 🔱177(GitHub API 核验)
  • License: MIT · 创建 2025-10-21 · 最近 push 2025-11-12(距今约 10 个月,⚠️ 迭代放缓)
  • 生态位:与作者 claude-skills(37+ 领域技能)、claude-code-tresor 构成三层工具生态

📦 可安装性 2.4/2.5

  • git clone 后在仓库目录启动 Claude Code 即可用(.claude/commands/ + .claude/agents/ 自动加载);9 个生产级 Skill 复制目录即装;无构建步骤。
  • 竞品对比 1(anthropics/skills 官方库):官方库只能复制现成 Skill,本仓库提供「生成 + 校验 + 安装」全链路。
  • 竞品对比 2(手工写 SKILL.md):零依赖但要啃 frontmatter 规范,新手常因格式错反复失败。

🎯 实用性 2.2/2.5

  • 四条产线(Skills/Agents/Prompts/Hooks)+ 69 个提示词预设跨 15 领域 + Codex CLI 桥(AGENTS.md 生成);/validate-output 提供格式兜底。
  • 竞品对比 1(claude-skills 同作者):那是即用技能库,本仓库是造技能的工厂,定位互补。
  • 竞品对比 2(裸对话让 Claude 写 Skill):无模板约束易漏字段,本仓库固化了官方格式与校验流程。

📖 文档质量 1.8/2.0

  • README 覆盖 3 个快捷入口、10 命令表、5 Agent 表、3 个完整工作流示例、目录树;documentation/templates/ 留有 4 份工厂提示词模板可精读。
  • 扣分点:README 内链指向 dev 分支,与默认 clone 的 main 分支存在路径差;无独立文档站。
  • 竞品对比 1(anthropics/skills):官方规范文档权威但不含生成流程文档。
  • 竞品对比 2(社区 awesome-claude-skills 类清单):只有链接没有方法论。

👥 社区活跃 0.9/1.5

  • 870★/177 fork 对工具型仓库属中上,但最近 push 停在 2025-11-12(约 10 个月前,⚠️⚠️ 单人维护、可能停滞);无版本发布节奏(README 标 v1.4.0)。
  • 竞品对比 1(anthropics/skills):官方维护、持续更新。
  • 竞品对比 2(obra/superpowers 等活跃社区仓库):迭代与社区响应明显更快。

🔗 兼容性 1.4/1.5

  • 绑定 Claude Code(.claude 目录约定),对 Codex CLI 通过 AGENTS.md 桥接而非原生;Windows 下需 Git Bash/WSL 执行示例命令。
  • 竞品对比 1(agent-skills 通用规范目录):跨 Claude/Codex/Gemini CLI 通用,本仓库生态半径小。
  • 竞品对比 2(npx skills add 类安装器):免 clone 直接装,本仓库需手动 git clone。

维度合计:2.4+2.2+1.8+0.9+1.4 = 8.7 ✓

🏷️ 标签说明

  • Skill系统: 产出物是 Claude Skills/Agents/Hooks/斜杠命令的生成体系。来源:官方 README
  • 开源免费: MIT 协议,本地运行无费用。来源:GitHub 仓库
  • Skill工厂: 定位是批量生产 Skill 的工具链而非技能库。来源:官方 README
  • Claude Code: 依赖 Claude Code 的 .claude 目录与斜杠命令机制。来源:官方 README
  • 提示词工程: Prompt Factory 提供 69 预设 × 4 输出格式的提示词生产线。来源:官方 README

局限与未实测声明:本文基于 2026-09-23 抓取的官方 README 与 GitHub API 数据撰写;未实际运行 10 个斜杠命令中的每一个(安装流程、问答体验、validate 校验规则均以 README 口径转述);仓库约 10 个月未更新,与最新版 Claude Code 的兼容性未验证;69 个提示词预设的质量未逐一评测。

📋 来源核实