skill-distill:把 Skill 蒸餾成可獨立運行的腳本

前言

在 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 到腳本」:

  1. 讀取源 Skill:針對你指定的 skill,加載其 SKILL.md 以及目錄內已有腳本。
  2. 生成獨立可執行腳本:輸出不依賴「當場再掛原 Skill 包」的可運行腳本(具體語言與入口以生成結果爲準,由源 Skill 內容與 distill 流程決定)。
  3. 嵌入 OpenClaw 模型配置:把當前環境下的 OpenClaw 模型配置寫進生成腳本,便於腳本直連模型、復現 Skill 中的模型調用方式。

官方列出的使用時機:

  1. 把某個 skill 轉換成獨立腳本工具;
  2. 提取 skill 的功能生成命令行工具;
  3. 將 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」:

  1. 確認 skill-distill 已出現在當前 Agent 的 skills 列表中。
  2. 明確源 skill(名稱、路徑或 SkillHub 座標),確保其 SKILL.md 與腳本在本地可讀。
  3. 在對話中說明目標:例如需要將某 skill 轉爲可獨立運行的腳本或命令行工具;若環境使用 OpenClaw,生成物會帶上當時的模型配置。
  4. 按 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

羽毛球分组比赛记分
小程序二维码

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

小夜