前言¶
自己写 SKILL.md 时，常见卡点不是「会不会写 Markdown」，而是三件事叠在一起：本地已经装了不少技能，新想法可能和旧能力重复；正文里容易漏掉权限、命令注入一类风险；写完还要分别对接虾评、GitHub、ClawHub 等发布路径。手工拆步骤、换工具，成本高也容易漏环节。
下面介绍 SkillHub 上的 技能创建器 v2.0（包名 @indiv-guipi/guipi-skill-factory，版本 v2.0.0）。它在 Agent 侧把「要不要新建、怎么写文档、能不能发出去」串成一条可复用的流程，适合已经习惯用通用 SKILL.md 格式扩展能力的开发者。
这是什么¶
技能创建器 v2.0 是面向 AI Agent 的全功能技能创建与发布 Skill：当用户想新建、安装、发布、更新任意技能时，由 Agent 按技能内说明触发并执行。
- 维护方：SkillHub 用户 南风（
user_2dc8a2f8/@indiv-guipi）。 - 分类：SkillHub 列表中为 ai-agent。
- 解决的问题：在创建或升级技能前做重叠判断与安全审计，生成或更新
SKILL.md，并可选择一键发布到 虾评、GitHub、ClawHub。
官方入口（用户页 API 与 SkillHub 技能页均可指向同一制品）：
- https://api.skillhub.cn/user_2dc8a2f8/guipi-skill-factory
- https://www.skillhub.cn/skills/indiv-guipi/guipi-skill-factory
核心功能¶
以下能力与 SkillHub 技能页简介一致，v2.0 相对旧版强调的三块增量也写在其中。
执行流程（四步）¶
- 重叠评估：扫描现有技能，评估与新需求的重叠度，给出 整合 / 升级 / 新建 三分支结论（v2.0 新增「技能整合评估」）。
- 安全检查：对
SKILL.md做自动安全审计，识别文档中的安全风险（v2.0 新增）。 - 创建或升级
SKILL.md：按结论撰写新技能或升级已有技能正文与元数据。 - 一键发布（可选）：集成发布到 虾评 + GitHub + ClawHub（v2.0 强调「一键发布集成」；具体调用方式以技能正文为准，通常会依赖你环境中已具备的相关发布/仓库管理能力）。
触发场景（官方描述）¶
当用户表达要新建、安装、发布、更新技能，或需要评估是否与现有技能重复时，适合启用本 Skill，由 Agent 按上述顺序推进。
安装与启用¶
SkillHub 推荐两种方式：把安装说明交给 Agent，或使用 skillhub CLI。安装时必须把技能装进当前 Agent 实际读取的 skills 目录，否则 Agent 不会加载（详见 SkillHub 安装文档）。
方式一：提示词交给 Agent¶
将下面整段发给当前 AI Client（Cursor、Claude Code 等均可），让其按官方安装文档操作：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@indiv-guipi/guipi-skill-factory`。
方式二：skillhub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，可按官方脚本安装（需网络权限）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
搜索并安装到本机 Agent 的 skills 目录（--dir 必填，路径因客户端而异）：
skillhub search guipi-skill-factory
skillhub install @indiv-guipi/guipi-skill-factory --dir <你的 skills 目录>
常见 skills 目录（摘自官方安装文档，以你当前环境为准）：
| 客户端 | 典型路径 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| workbuddy | ~/.workbuddy/skills/ |
安装后按所用 Client 的要求重启或刷新技能列表。各变体（OpenClaw 系等）目录名可能不同，以 skillhub.md 第四节为准。
典型用法¶
下面是可以直接复现的对话路径，不依赖额外案例数据。
1. 从需求开始¶
用自然语言说明你想做的技能，例如：触发场景、输入输出、是否访问外部 API。Agent 加载 技能创建器 v2.0 后，会先进入重叠评估，避免与本地已有技能重复建设。
2. 根据三分支结论继续¶
- 整合：在现有技能上合并能力，而不是新建目录。
- 升级：在原有
SKILL.md上增量修改版本与说明。 - 新建：创建新的技能包与
SKILL.md。
3. 通过安全检查后再定稿¶
在定稿前完成 SKILL.md 安全审计。若审计指出高风险表述（如不当 shell、敏感信息硬编码等），应先改文档再进入发布环节。
4. 可选：多平台发布¶
文档就绪后，按技能内指引选择是否发布到 虾评、GitHub、ClawHub。发布前请确认对应账号、令牌与目标仓库/社区权限已配置，否则一键步骤会在某一环失败。
适用场景与注意¶
适合谁
- 经常在本地维护多份 Agent Skill，需要统一「评估 → 写作 → 审计 → 发布」节奏的团队或个人。
- 希望减少重复技能、并希望在上线前对
SKILL.md做一轮安全扫视的开发者。
限制与注意
- 重叠评估依赖 Agent 能访问到的本地/已安装技能集合；扫描范围以外的工作区技能可能评估不到。
- 「一键发布」依赖虾评、GitHub、ClawHub 及相关辅助技能或凭据；未配置时，前三步仍可用，发布需手工完成。
- SkillHub 页面上的下载量、星级会随时间变化；查阅时以 技能详情页 为准。
- 用户提供的 API 地址
https://api.skillhub.cn/user_2dc8a2f8/guipi-skill-factory在部分环境下可能无法直接 GET；浏览与安装以 SkillHub 技能页与skillhub.md为准。
结尾¶
技能创建器 v2.0 把重叠判断、安全审计、SKILL.md 编写与多平台发布收进同一条 Agent 工作流，适合作为 SkillHub 生态里「造技能」的默认入口。需要安装或更新时，使用包名 @indiv-guipi/guipi-skill-factory，并参考官方页：https://www.skillhub.cn/skills/indiv-guipi/guipi-skill-factory 。
