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
羽毛球分组比赛记分
小程序二维码

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

小夜