前言¶
在 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