前言¶
在 Cursor、Claude Code 等环境里,Skill 实质是一份带触发条件的 SKILL.md 指令包:写得好,Agent 会在合适场景自动套用;写得散、缺约束,则容易漏触发或行为漂移。很多人卡在两件事——不知道从零怎么搭结构,已有 Skill 也不知道哪里该改。
下面介绍 SkillHub 社区 Skill「Skill制作大师」(@user_66f29720/skill--forge,v1.0.0),面向「新建」和「审计优化」两条路径,用对话生成成品,或用扫描评分给出改进建议。
这是什么¶
Skill制作大师 是 SkillHub 上分类为 ai-agent 的社区 Skill,发布者为 user_66f29720。页面标注 requires_api_key=false,安装后无需额外 API Key。
它解决两类问题:
- 从零创建:用自然语言描述想法,由 Skill 引导产出符合通用
SKILL.md格式的 Skill 成品。 - 质量检测与优化:对已有 Skill 做扫描、评分,并给出可执行的改进建议。
官方 Skill 页:Skill制作大师 - SkillHub。资源坐标页:api.skillhub.cn。
核心功能¶
资料中明确的能力只有两大模式,其余细节以安装后的 SKILL.md 为准。
对话式生成(说想法 → 出成品)¶
适合还没有成稿、只有场景与目标的情况。在 Agent 对话里用官方列出的创建类触发词唤起后,按 Skill 的引导补充需求,最终落到可安装的 Skill 结构(基于通用 SKILL.md 格式)。
质量检测(扫描 → 评分 → 改进建议)¶
适合已有 Skill 目录或文稿、需要对照规范查漏的情况。用检查、优化、审计类触发词唤起后,对现有 Skill 做扫描与评分,并输出改进方向,便于迭代后再发布到 SkillHub 或本地 skills 目录。
触发词¶
官方列出的触发词如下,中英文混用均可作为入口:
- 创建类:
做skill、创建skill、制作skill、写skill、skill forge、技能制作 - 审计类:
检查skill、优化skill、审计skill
安装与启用¶
安装流程遵循 SkillHub 通用说明:SkillHub 安装与优先源配置。要点是:用 skillhub CLI 安装,且 --dir 必须指向当前 Agent 实际读取的 skills 目录,否则默认装到 ./skills/ 可能不会被识别。
1、检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装,可使用官方推荐的一键安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
将包名 @user_66f29720/skill--forge 装入选定目录。官方页面也给出了等价提示:请根据 https://skillhub.cn/install/skillhub.md 安装 @user_66f29720/skill--forge。
skillhub install @user_66f29720/skill--forge --dir <skills目录>
常见 Agent 的 skills 路径(摘自 SkillHub 安装文档,按你当前环境选用其一):
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装完成后,按你所用 Client 的要求重启或刷新 Agent,使新 Skill 被加载。
也可将下面提示交给 AI,由其按安装文档执行(与 SkillHub 页面文案一致):
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_66f29720/skill--forge。
典型用法¶
官方简介未提供逐步截图或样例仓库,可复现的用法即「触发词 + 模式」组合。
新建 Skill
- 确认
@user_66f29720/skill--forge已出现在当前 Agent 的 skills 目录并已加载。 - 在对话中说明目标,并带上创建类触发词之一,例如:
制作skill:我想做一个帮团队写 PR 描述的 Skill,触发条件是用户提到 PR 标题。 - 按 Skill 追问补全场景、约束、输出格式;完成后将生成的
SKILL.md(及附属文件)保存到你的 skills 目录或打包发布。
审计已有 Skill
- 在对话中附上现有
SKILL.md内容或说明本地路径(若 Agent 可读工作区文件)。 - 使用审计类触发词,例如:
审计skill,请扫描并评分,给出改进建议。 - 根据扫描与评分结果修改文稿,再视需要重新检测。
经过上面的步骤,同一 Skill 可在「创作」与「复盘」之间切换,而不必另找一套检查清单。
适用场景与注意¶
适合谁
- 第一次在 SkillHub / Cursor skills 生态里写 Skill 的开发者。
- 维护多个 Skill、需要统一质量口径的团队或个人。
- 希望用自然语言起草,再落到
SKILL.md规范的人。
限制与注意
- 产出质量仍依赖你对业务场景的描述是否具体;触发词只负责唤起 Skill,不能替代需求澄清。
- 页面统计(截至资料抓取):社区来源、评分 100000、下载 3182;与实时 SkillHub 展示可能略有差异,以官网为准。
- 未标注必须 API Key,但若你生成的 Skill 内部引用外部服务,下游 Skill 仍可能要求 Key,需在成稿里自行声明。
- 不同 Agent 的 skills 路径不同,安装时
--dir写错是最常见的「装了却不起效」原因。
结尾¶
Skill制作大师把「写 Skill」和「查 Skill」收进同一个社区包:创建走对话式生成,维护走扫描评分与建议。若你正在 SkillHub 上打磨 ai-agent 类能力,可从官方页安装 v1.0.0,用触发词直接开工。
- SkillHub 详情:https://www.skillhub.cn/skills/user_66f29720/skill–forge
- 坐标资源:https://api.skillhub.cn/user_66f29720/skill–forge
- 安装说明:https://skillhub.cn/install/skillhub.md