Community程式設計與開發github.com

hsiu1214/skill-worth

在安裝 Skill 前先問一句:這個值得裝嗎?它掃描 Skill 目錄,檢查宣稱的功能是否有對應的實作撐腰——有可執行的程式碼,或步驟清單完整的文件,就算過關;說要做某件事卻一行實作都沒有,就標示「別裝」。也能盤點已安裝的 Skill,指出哪些可以刪除。

skill-worth 是什麼?

這是一個專為 AI Agent Skill(如 Claude Code、Cursor、Codex 等平台所用)設計的品質驗證工具,核心價值在於幫助使用者判斷一個 Skill 是否真的具備宣稱的功能,還是只有華麗的敘述但缺乏實作。它採用靜態分析,從實質功能、宣稱為實、說明清楚、安全性、維護性等五個維度加權評分,並設有直接判「別裝」的紅線(如作者自承未實作、宣稱動手卻無程式碼等)。支援評估未安裝的 Skill(指定路徑)、盤點已安裝的所有 Skill(自動偵測常見平台目錄)、以及批量掃描市集熱門 Skill(需網路)。結果以 HTML 報告呈現,並可輸出 JSON。此工具本身不執行被掃描的程式碼,只檢查檔案結構與內容是否存在,因此無法判斷程式碼品質好壞,但能有效過濾「空殼」Skill,避免浪費時間與信任。實測發現,安裝量高的 Skill 中仍有約 11% 為空殼,下載量與品質無直接關聯。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add hsiu1214/skill-worth

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Skill 值不值得裝

一句話:判斷一個 skill 是真能幹活,還是只有一段漂亮話。

市集上很多 skill 下載量很高,裝上去卻什麼也不做——文件裡全是「風險等級」「門禁檔位」這類套模板的話,或者作者自己寫著「操作細節待補全」。安全掃描器不會報它們,因為它們確實不偷東西,只是什麼都不做。

這個 skill 就查這件事。

什麼時候用

  • 看到市集裡某個 skill 想裝,拿不準 → 先評估
  • 裝完感覺沒效果,想知道是不是白裝了 → 查一下
  • 裝了一堆 skill,想清理 → 盤點全部,按分數排序
  • 自己寫了個 skill,想確認別人下載後能真的用起來 → 自查

怎麼用

pip install git+https://github.com/hsiu1214/skill-worth.git

(還沒上 PyPI,直接從倉庫裝)

評估一個還沒裝的 skill:

skill-worth check /path/to/some-skill

盤點已經裝好的全部 skill(自動找 WorkBuddy / Claude Code / Codex 等常見目錄):

skill-worth check

順便看看市集整體情況(會下載並實測一批熱門 skill,需要網路):

skill-worth market --top 30

跑完會在當前目錄生成 skill-worth-report.html,雙擊就能看。加 --open 直接打開,加 --json out.json 另存原始數據。

不想裝包也能直接跑源碼:

python -m skill_worth check /path/to/skill

結果怎麼讀

三檔:

檔位意思該怎麼辦
值得裝(70 分以上)有能跑的東西,也說得清自己做什麼裝上用
看你要什麼(40–69)不是空殼,但有短板看你缺不缺這塊,別指望萬能
別裝(40 分以下)聲稱的事找不到實作別裝;已經裝了可以卸

分檔之外還有一句話結論和幾條理由,理由後面可以展開「看證據」,那裡列的是實際檔案數、行數、哪幾個檔案找不到。

判據

沒有程式碼不等於沒用。 這是最容易判錯的地方,所以要單獨說清楚:

  • 知識型:一份檢查清單、一套寫作方法、一個診斷流程。它的價值就在文字裡,不需要程式碼。skill-vetter(14 萬下載)就是 140 行純文件,它完全正常。
  • 動手型:宣稱要爬數據、跑引擎、批次處理、呼叫 API。這類如果沒有程式碼,就是空的。

分不清時看它怎麼說自己:說「教你判斷」的是知識型,說「幫你抓取」的是動手型。

五個維度,加權 100 分:

維度權重看什麼
實質功能40有沒有能跑的程式碼;純文件的話,步驟/清單/範例是否寫全
宣稱為實25說的和做的一致嗎;提到的檔案真的在嗎
說明清楚15一句話能不能說清用途;觸發詞是否過多
安全10有沒有刪除、動態執行、硬編碼密鑰
維護10目錄結構是否完整、有無套模板的空話

命中以下任意一條,直接判「別裝」,不看總分:

  1. 作者自己寫明「還沒實作」
  2. 說要動手做事,但沒有一個程式碼檔案
  3. 有程式碼檔案,但裡面只有 pass / TODO / 空函數

有一條只提示、不判死:文件裡寫的工具名和當前宿主不一致。因為工具名本來就隨宿主變——同一個抓取功能,這邊叫 WebFetch,別處可能就叫 web_fetch。把它當硬傷會跨平台誤殺,所以只寫進理由裡提醒你確認。

實測過的例子

skill結果依據
multi-search-engine(204 萬下載)別裝宣稱 16 個引擎,零腳本——說的跟做的對不上
summarize(4.6 萬下載)別裝2 個檔案共 3.5KB,作者自承「由規劃規格自動落地生成,操作細節待補全」
skill-vetter(14 萬下載)值得裝純文件,但有 4 步審查協議 + 輸出格式 + 可直接執行的命令
self-improving-agent(8.6 萬下載)值得裝5 個真程式碼檔案,hook 只做記憶體注入,零外連

前兩個安裝量加起來 200 多萬,但都是空的。下載量和品質基本無關。

2026-10 實測的一組市集數據(抽樣安裝量 ≥500 的 30 個熱門 skill,成功掃到 28 個):

  • 24 個值得裝,1 個看你要什麼,3 個別裝(11%)
  • 這 28 個合計被安裝 55.2 萬次,其中被判「別裝」的 3 個占了 10.5 萬次
  • 那 3 個的判定理由一字不差,且都來自同一批鏡像同步——同一套模板批量生產的

局限

  • 只做靜態分析,不執行任何被掃描的程式碼
  • 判斷不了「程式碼寫得對不對」,只能判斷「有沒有」
  • 用途描述很短但實際很好用的 skill,會被低估
  • 反過來說,寫得很漂亮但實際難用的 skill,可能被判高——這個工具查的是「有沒有」,不是「好不好用」

隱私

報告生成時會自動剝掉本機絕對路徑和內部命名空間,skillsDir 只顯示末兩段。可以直接發給別人。

相關技能