前言¶
在 Agent 裏掛着一個 Skill,流程跑得很順,但一旦要交給同事、塞進 CI,或者在沒有完整 Agent 的環境裏複用,往往會卡在「還得帶着整套 Skill 目錄和對話上下文」。反過來,手寫一個命令行工具,又容易和 SKILL.md 裏已經寫好的步驟脫節,維護兩套東西。
下面介紹 SkillHub 上的 skill-distill(座標 @user_9d88e4b9/skilldistill):它面向「已有 Skill、想要可執行腳本」這一路徑,由 Agent 讀取目標 Skill 的說明與腳本,生成帶當前 OpenClaw 模型配置的獨立可執行產物。
這是什麼¶
skill-distill 是社區來源(community)的 dev-programming 類 Skill,當前版本 1.0.0,發佈者爲 user_9d88e4b9。
一句話定位:將現有 skill 轉換爲可執行的腳本工具——讀取指定 skill 的 SKILL.md 和腳本,生成獨立的可執行腳本,並在腳本中嵌入當前 OpenClaw 模型配置。
官方入口:
- SkillHub 頁面:https://www.skillhub.cn/skills/user_9d88e4b9/skilldistill
- API 座標頁:https://api.skillhub.cn/user_9d88e4b9/skilldistill
(SkillHub 頁面數據截至抓取時:評分 100000,下載 776;標籤含 requires_api_key=true,使用相關能力時需自行準備 API Key。)
核心功能¶
依據官方簡介,skill-distill 只做一件事鏈路上的幾步,且都圍繞「從 Skill 到腳本」:
- 讀取源 Skill:針對你指定的 skill,加載其
SKILL.md以及目錄內已有腳本。 - 生成獨立可執行腳本:輸出不依賴「當場再掛原 Skill 包」的可運行腳本(具體語言與入口以生成結果爲準,由源 Skill 內容與 distill 流程決定)。
- 嵌入 OpenClaw 模型配置:把當前環境下的 OpenClaw 模型配置寫進生成腳本,便於腳本直連模型、復現 Skill 中的模型調用方式。
官方列出的使用時機:
- 把某個 skill 轉換成獨立腳本工具;
- 提取 skill 的功能生成命令行工具;
- 將 skill 封裝爲可直接運行的腳本。
公開資料中未給出單獨的子命令手冊;實際執行通常是在已安裝本 Skill 的 Agent 中,按 SKILL.md 的指引指定目標 skill 並觸發蒸餾流程。
安裝與啓用¶
SkillHub 推薦先具備 skillhub CLI,再把技能裝到當前 Agent 能識別的 skills 目錄。安裝說明以 https://skillhub.cn/install/skillhub.md 爲準。
1、檢查或安裝 skillhub CLI¶
command -v skillhub && skillhub --version
若未安裝,可用官方腳本(完整安裝含默認 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-distill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄,否則默認落在 ./skills/,Agent 可能識別不到。
skillhub install user_9d88e4b9/skilldistill --dir <你的 skills 目錄>
SkillHub 頁面也給出了等價提示:根據 https://skillhub.cn/install/skillhub.md 安裝 @user_9d88e4b9/skilldistill。
常見客戶端 skills 路徑(來自 SkillHub 安裝文檔,按你實際環境選用):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
裝到對應目錄後,按你所用客戶端的要求刷新或重啓 Agent,使新 Skill 生效。
典型用法¶
公開頁面未附帶逐步截圖或固定 shell 示例;可復現的流程應理解爲「在 Agent 內啓用 skill-distill,再指向要被蒸餾的 skill」:
- 確認 skill-distill 已出現在當前 Agent 的 skills 列表中。
- 明確源 skill(名稱、路徑或 SkillHub 座標),確保其
SKILL.md與腳本在本地可讀。 - 在對話中說明目標:例如需要將某 skill 轉爲可獨立運行的腳本或命令行工具;若環境使用 OpenClaw,生成物會帶上當時的模型配置。
- 按 Agent 執行蒸餾後的輸出,在本地對生成腳本做執行權限與依賴檢查(源 Skill 若依賴外部 API,仍受
requires_api_key=true等約束影響)。
經過上面的步驟,你得到的是一份可脫離「原 Skill 包 + 當場掛載」的腳本形態,而不是繼續在 Agent 裏重複同一套手動步驟。
適用場景與注意¶
適合誰
- 已經把能力沉澱在 Skill(
SKILL.md+ 腳本)裏,希望再交付一層「命令行 / 單文件可執行」的開發者; - 使用 OpenClaw 生態,希望蒸餾結果自帶當前模型配置、減少手工拷貝配置項的情況。
限制與注意
- 標籤
requires_api_key=true:涉及模型或第三方 API 時,需自行管理密鑰,不要把密鑰寫進不可信的共享腳本倉庫。 - 蒸餾質量取決於源 Skill 的文檔完整度與腳本結構;文檔含糊的 Skill,生成腳本也可能需要人工收尾。
- 評分與下載量來自 SkillHub 展示,會隨時間變化;以安裝前頁面爲準。
- 本文未覈實 Cursor / Codex / Claude Code 在「觸發 distill」上的 UI 差異,僅安裝路徑以 SkillHub 文檔爲準。
結尾¶
如果你手裏已經有一個維護良好的 Skill,卻還需要在無 Agent 的場景裏跑同一套邏輯,skill-distill 提供的是從 SKILL.md 和腳本出發、落到可執行腳本並帶上 OpenClaw 模型配置的一條官方描述路徑。安裝與座標以 SkillHub 爲準:
https://www.skillhub.cn/skills/user_9d88e4b9/skilldistill