Skill制作大师:从零写 Skill 与质量审计

前言

在 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。

它解决两类问题:

  1. 从零创建:用自然语言描述想法,由 Skill 引导产出符合通用 SKILL.md 格式的 Skill 成品。
  2. 质量检测与优化:对已有 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

  1. 确认 @user_66f29720/skill--forge 已出现在当前 Agent 的 skills 目录并已加载。
  2. 在对话中说明目标,并带上创建类触发词之一,例如:制作skill:我想做一个帮团队写 PR 描述的 Skill,触发条件是用户提到 PR 标题。
  3. 按 Skill 追问补全场景、约束、输出格式;完成后将生成的 SKILL.md(及附属文件)保存到你的 skills 目录或打包发布。

审计已有 Skill

  1. 在对话中附上现有 SKILL.md 内容或说明本地路径(若 Agent 可读工作区文件)。
  2. 使用审计类触发词,例如:审计skill,请扫描并评分,给出改进建议。
  3. 根据扫描与评分结果修改文稿,再视需要重新检测。

经过上面的步骤,同一 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye