開源一個Skill管理神器

作者:AI產品黃叔
日期:2026年4月13日 上午3:33
來源:WeChat 原文

整理版優先睇

速讀 5 個重點 高亮

黃叔開源 Skill Hub,一個可視化嘅 Skill 管理神器,幫你解決版本回退、多設備同步等煩惱

整理版摘要

呢篇文係黃叔分享佢自己開發並開源咗一個叫 Skill Hub 嘅工具。黃叔本身係 AI 玩家,成日研究同玩 Skill,仲有個社羣教人寫同用 Skill。佢發現自己電腦入面嘅 Skill 超過 100 個,社羣唔少用戶都遇到管理混亂、改壞咗冇得還原、揾唔到邊度有重複等問題。

佢諗過用 Git 做版本管理,但對普通用戶嚟講門檻太高。於是決定整一個可視化界面,將 Git 嘅能力包裝成點幾下就搞掂。第一版靠 Claude Code 寫核心功能:掃描所有常見位置嘅 Skill、展示同搜尋、直接喺瀏覽器編輯同自動拍快照。

放上社羣之後,收到好多意外需求:有人用 Codex 唔係 Claude Code,掃描要支援多平台;有人有幾部電腦,需要同步 167 個 Skill;有人要批量刪除。佢迭代咗相似檢測(揾出重複內容)同比 Git 同步(用 GitHub 私有倉庫做後端,用戶唔使識 Git 指令)。結論係:需求唔係諗出來,係用出來。

  • 核心解決方案:將 Git 版本管理能力包裝成可視化操作,降低門檻,新手都用到。
  • 主要功能包括:全局掃描(支援 Claude CodeCodex 等多平台)、瀏覽器直接編輯、自動快照回退、相似檢測、多設備 Git 同步。
  • 相似檢測可以有效找出內容重疊 80% 以上嘅近似 Skill,幫你清理冗餘。
  • 多設備同步用 GitHub 私有倉庫做免費後端,用戶只需設定倉庫地址加 TokenGit 背後處理衝突同增量同步。
  • 開發過程證明:需求來自真實用戶場景,唔係靠空想;離用戶夠近嘅產品先解決到真正嘅問題。
值得記低
工具 github.com

Skill Hub 一鍵安裝指令

透過 npm 安裝,一行指令啟動:npm install -g && skill-hub

連結 github.com

GitHub 倉庫

黃叔放咗成個項目嘅原始碼同說明。

整理重點

社羣入面嘅痛點,就係產品嘅起點

黃叔喺社羣教人寫 Skill、用 Skill 嘅時候,成日聽到兩類問題:Skill 愈裝愈多,點管理?改咗效果差咗,點返轉頭?佢自己都有一樣嘅煩惱——電腦入面超過 100 個 Skill,散落喺唔同目錄,靠記憶揾,改壞咗冇得還原。

佢一直想做產品解決社羣嘅真實問題,今次機會到咗。

整理重點

Git 係正確答案,但門檻太高

作者第一反應係 Git——Skill 本質係文件夾加純文本,用 Git 做版本管理好合理。但社羣大部分唔係程式設計師,叫佢哋學 Git 指令等於勸退。佢想揾個 可視化嘅方法,將 Git 能力包裝成點幾下就搞掂。

於是佢諗到喺 Skill Hub 入面,每個 Skill 都有版本歷史按鈕,改壞咗點一下「回退」就得,唔使學任何 Git 指令。

整理重點

用 Claude Code 搭第一版

想清楚核心功能之後,黃叔就交畀 Claude Code 寫代碼。核心邏輯得三樣嘢:掃描、展示、編輯。

  • 掃描覆蓋所有常見位置:全局 Skill 目錄、插件目錄(遞歸)、專案目錄、常見開發路徑,仲會往上一層掃多三級。一次掃描聚合超過 100 個 Skill。
  • 展示可以按來源分組、按作用域分組、按專案篩選、按關鍵詞搜尋,終於唔使再用 find 指令。
  • 編輯直接喺瀏覽器改 SKILL.md,每次保存前自動影一個版本快照,改壞咗隨手回滾。

一行指令啟動:skill-hub,瀏覽器自動開 localhost:3456。第一版搞掂咗「睇得見、揾得到、改得了、退得回」。

整理重點

真實用戶嘅反饋,先係真正嘅需求來源

第一版放上社羣之後,反應好快,而且每一條都係意料之外。有人用 Codex 唔係 Claude Code,掃描器一開始只掃 ~/.claude/skills,但社羣有人用多個平台,Skill 散落喺唔同位置。呢啲 使用場景唔親身經歷過,真係諗唔到。

仲有人有兩部電腦Mac mini 家用,MacBook Air 出門用,167 個 Skill 點同步?呢個需求背後好多決策點:衝突策略(兩邊都改咗同一個 Skill 以邊個為準)、增量 vs 全量、網絡異常處理、多設備支援、私有 Skill 排除 API key 等。作者話:「呢啲細節喺 PPT 永遠唔會出現,只有手沾泥巴先會撞到。」

另外有好多簡單但高頻嘅需求,例如 批量刪除,167 個 Skill 入面有好多試驗品,一個一個刪太痛苦。呢啲反饋全部變成下一版功能。

整理重點

相似檢測同 Git 同步嘅精巧設計

有兩個功能值得詳細講。第一個係 相似檢測。作者掃完之後發現自己有好幾對「幾乎一樣」嘅 Skill,內容重疊 80% 但名唔同。社羣好多人都有呢個問題。佢加咗基於關鍵詞嘅相似度檢測,自動將疑似重複嘅 Skill 聚類,可以睇到內容差異,決定保留邊個。等於幫個 Skill 庫做一次體檢。

第二個係 Git 同步多設備。作者最初想自建一套 sync 協議,但考慮到衝突處理、增量傳輸、斷點續傳,每個都好複雜。最後決定用 GitHub 私有倉庫做免費後端:本地 Skill → git push → GitHub 私有倉庫 → git pull → 另一部機。衝突處理交畀 git merge,增量同步 Git 天然只傳 diff,私有倉庫免費唔使伺服器。用戶只需要喺界面設定一個倉庫地址加一個 Token,就搞掂多端同步。Mac mini push,MacBook Air pull,用戶唔使識一行 Git 指令。

一鍵安裝指令 bash
npm install -g
https://github.com/Backtthefuture/skillmanager/raw/main/release/claude-skill-hub.tgz && skill-hub

你電腦入面有幾多個 Skill?

我數咗一下,超過100個

作為一直喺度研究同玩 Skill 嘅 AI 玩家,唔覺唔覺發現自己好似有咗太多 Skill,係嘅,成個超過100個。

仲發現自己嘅社羣用戶喺 Skill 管理方面遇到咗各式各樣嘅問題。

有必要去做一個 Skills 管理神器。係嘅,黃叔已經將佢開源,一鍵安裝,功能強大。下面同大家介紹下點樣用佢嚟方便你嘅 skill 管理。

只要你嘅 skill 超過20個,我就建議你裝一個,非常簡單。

01

PART

社羣入面嘅問題,就係產品嘅起點

我自己做社羣,教大家寫 Skill、用 Skill。每日社羣入面都有人分享自己寫嘅 Skill,亦都有人問各種問題。

教嚇教嚇,有兩類問題開始重複出現:

「黃叔,Skill 越裝越多,點樣管理啊?」

「黃叔,我改咗一個 Skill 效果變差咗,點樣回到上一版?」

講真,見到呢啲問題嘅時候我愣咗一下——因為我自己都有完全一樣嘅困擾。

我甚至唔知自己電腦入面到底有幾多個 Skill。覺得好多,但係唔知佢哋喺邊,唔知點樣管理,唔知都有啲咩。就係好亂。

有些在 ~/.claude/skills/,有啲喺插件目錄下面三四層,有啲喺某個項目嘅 .claude/skills/ 入面——嗰個項目我已經兩個月冇打開過。想揾一個 Skill?靠記憶。想改一個 Skill?翻目錄。改壞咗想退回?冇版本歷史。

我一直想俾社羣用戶做一啲產品,嚟解決佢哋真係遇到嘅問題。今次,佢哋嘅問題同我嘅問題完全重合咗。

咁就做啦。

02

PART

Git 係正確答案,但門檻太高

譬如版本管理呢件事,我第一反應諗到嘅係 Git。

Skill 嘅本質就係一個文件夾,入面就係 SKILL.md 同埋一啲設定檔。文件夾 + 純文字,天然適合用 Git 管理。git initgit commit、改壞咗 git checkout 返去——所有問題都解決曬。

我亦都確實想教大家用 Git 嚟管理 Skill 版本。

但諗咗諗,呢件事對普通用戶嚟講門檻太高。

我社羣入面大部分人唔係程序員。佢哋學識咗用 Claude Code 寫 Skill,已經好叻。你而家同佢哋講「裝個 Git,學嚇 commit、push、pull、merge,遇到衝突要手動解決」——呢個唔係幫佢哋,係趕走佢哋。

有冇一種可視化嘅方式,將 Git 嘅能力包喺一個用戶友好嘅界面入面?等版本管理、Skill 揾尋、衝突檢測呢啲事,變成㩒一下滑鼠就搞得掂嘅操作。

我喺Skill管理器入面,只要㩒開任意一個Skill,就可以睇到版本歷史掣,㩒一下,就可以快速完成版本管理:

圖片

圖片


呢個就係 Skill Hub 嘅起點——俾社羣入面嘅普通用戶,做一個佢哋真正用得嚟嘅 Skill 管理器。

03

PART

等 CC 幫手砌第一版

諗清楚要啲咩之後,淨低嘅交俾 Claude Code。我描述需求,CC 寫程式碼,中間遇到問題佢自己 Debug。核心邏輯就三件事:掃描、展示、編輯

掃描覆蓋曬所有諗到嘅位置:全域 Skill 目錄、插件目錄(遞迴)、註冊過嘅項目目錄、常見開發路徑(~/Documents~/Projects~/Developer……),甚至會向當前目錄嘅上面再掃三級。

一次掃描,100+個 Skill 全部聚合到一個頁面。每個 Skill 有名字、描述、來源(本地 / 插件 / 符號連結)、作用域(全域 / 項目)、最後修改時間。

展示可以按來源分組、按作用域分組、按項目篩選、按關鍵字搜索。終於唔使 find 了。

圖片


編輯直接喺瀏覽器入面改 SKILL.md,保存就生效。而且每次保存前會自動影一個版本快照——改壞咗隨時回滾。唔使學 Git,㩒一下「回退」就得。

一條命令啟動:

skill-hub

瀏覽器自動打開 localhost:3456,搞掂。

第一版解決咗最核心嘅問題:睇得到、揾得到、改得到、退得到。

04

PART

放上社羣之後,需求先真正開始

第一版做完放上社羣之後,反應好快。而且每一條我都冇預料到。

有人用 Codex,唔只係用 Claude Code。 我寫掃描器嘅時候只掃咗 ~/.claude/skills,因為我自己只用 Claude Code。但社羣入面有人同時用 Codex、Cline、Warp,Skill 散落喺完全唔同嘅位置。

呢個唔係「諗唔到」,係冇使用場景就冇感覺

圖片


有人有兩部電腦。 Mac mini 喺屋企當主力寫 Skill,MacBook Air 出街用。167 個 Skill,點樣同步?

呢個需求聽起嚟就係「上載下載」。但一展開,全部係決策點:

問題
點解難
衝突策略
兩邊都改咗同一個 Skill,以邊個為準?
增量 vs 全量
100+ 個 Skill 每次全量比對太慢,增量需要維護狀態
網絡異常
同步到一半斷咗,部份寫入算唔算污糟數據?
多設備
唔止兩部,可能枱機 + 手提 + 公司電腦
私有 Skill
有啲 Skill 入面有 API key,使唔使排除?

呢啲細節喺簡報入面永遠唔會出現。只有落手落腳嗰陣先會一個個撞到。


仲有人話刪 Skill 可唔可以批量? 簡單但高頻。167 個 Skill 入面有唔少試驗品,一個一個刪太痛苦。

圖片


每條反饋都變咗下一版功能。

05

PART

每條反饋都變咗下一版

基於呢啲反饋,密密迭代。批量刪除加回收站、衝突標記、啟用停用開關呢啲都係常規操作,做咗就有。

但有兩個功能值得拎出嚟講。

第一個係相似檢測

掃出嚟167 個 Skill 之後我自己都嚇咗一跳——我居然有幾對「幾乎一樣」嘅 Skill。同一個功能,唔同時間寫嘅,名唔同但內容重疊度 80%。社羣入面好多人都有呢個問題:裝咗七八十個 Skill,根本記唔清邊啲撞咗。

所以加咗基於關鍵字嘅相似度檢測。自動將疑似重複嘅 Skill 聚類展示,支援中英混雜匹配。㩒入去可以睇兩個 Skill 嘅內容差異,決定保留邊個。相當於幫你嘅 Skill 庫做咗一次「身體檢查」

圖片


第二個係 Git 同步

多裝置同步呢個需求,我一開始想自己做一套 sync 協議。但馬上否決咗——衝突處理、增量傳輸、斷點續傳,每個攤開嚟都係一個工程。

然後我諗到:呢啲問題 Git 全部都解決曬。

最終方案係用 GitHub 私人倉庫當免費後端:

本地 Skill → git push → GitHub 私有倉庫 → git pull → 另一台設備

衝突處理交俾 git merge,增量同步 git 天然只傳 diff,私人倉庫免費唔使搭伺服器。用戶只需要喺界面上設定一個倉庫地址加一個 Token,就可以做到多端同步。Mac mini push,MacBook Air pull,唔使識一句 Git 命令。

圖片


將複雜度交俾 Git,我只做上層體驗。呢個同搭知識庫嘅邏輯一樣——唔係咩都自己造,係揾到好嘅基礎設施,喺上面做好用戶睇得到嘅嗰一層。

06

PART

需求唔係諗出嚟嘅,係用出嚟嘅

回過頭嚟睇呢個項目,我覺得最值得紀錄嘅唔係功能列表,而係一個體會:

需求唔係諗出嚟嘅,係用出嚟嘅。

每一個「我諗唔到」嘅功能——多平台掃描、相似檢測、多裝置同步——都唔係我坐喺度諗出嚟嘅。係真實用戶攞住佢哋嘅真實場景,幫我撞出嚟嘅。

喺社羣入面教 Skill 嘅好處係,我離用戶夠近。痛點唔使調研,唔使問卷,佢哋每日自己會彈出嚟。

做產品嘅第一步唔係畫原型,係自己先用起嚟,然後掉俾真實用戶。佢哋嘅使用習慣,就係最好嘅產品經理。


Skill Hub 而家開源咗,一條命令就用得:

npm install -g https://github.com/Backtthefuture/skillmanager/raw/main/release/claude-skill-hub.tgz && skill-hub

成個倉庫放喺:https://github.com/Backtthefuture/huangshu


如果你嘅 Claude Skill 超過咗 20 個,你可能已經需要佢。

如無必要,勿增實體。基於呢個原則,我並冇去開發 Mac 版本,我覺得用瀏覽器就夠簡單。如果唔小心你㩒熄咗瀏覽器,可以用一條命令,喺終端機入面就可以重新打開佢。

skill-hub

我都做咗條片介紹,歡迎大家去睇:


你電腦裏有多少個 Skill?

我數了一下,超過100個

作為一直在研究和玩耍Skill的AI玩家,不知不覺發現自己似乎有了太多的Skill,是的,整整超過100個。

也發現自己的社羣用戶在 Skill 上面管理遇到了各種各樣的問題。

有必要去做一個 Skills 管理神器。是的,黃叔已經把它開源,一鍵安裝,功能強大。下面來給大家介紹一下怎麼用它來方便你的 skill 管理。

只要你的 skill 超過20個,我就建議你裝一個,非常的簡單。

01

PART

社羣裏的問題,就是產品的起點

我自己做社羣,教大家寫 Skill、用 Skill。每天社羣裏都有人在分享自己寫的 Skill,也有人在問各種問題。

教着教着,有兩類問題開始反覆出現:

"黃叔,Skill 越裝越多,怎麼管理啊?"

"黃叔,我改了一個 Skill 效果變差了,怎麼回到上一版?"

說實話,看到這些問題的時候我愣了一下——因為我自己也有完全一樣的困擾。

我甚至都不知道自己電腦裏到底有多少個 Skill。感覺很多,但不知道它們在哪,不知道怎麼管理,不知道都有什麼。就是很亂。

有些在 ~/.claude/skills/,有些在插件目錄下三四層,有些在某個項目的 .claude/skills/ 裏——那個項目我已經兩個月沒打開了。想找一個 Skill?靠記憶。想改一個 Skill?翻目錄。改壞了想退回去?沒有版本歷史。

我一直想給社羣用戶做一些產品,來解決他們真實遇到的問題。這次,他們的問題和我的問題完全重合了。

那就做吧。

02

PART

Git 是正確答案,但門檻太高

比如版本管理這件事,我第一反應想到的是 Git。

Skill 的本質就是一個文件夾,裏面就是 SKILL.md 和一些配置文件。文件夾 + 純文本,天然適合用 Git 管理。git initgit commit、改壞了 git checkout 回去——所有問題都解決了。

我也確實想教大家用 Git 來管理 Skill 版本。

但想了想,這件事對普通用戶來說門檻太高了。

我社羣裏大部分人不是程序員。他們學會了用 Claude Code 寫 Skill,已經很厲害了。你現在跟他們說"裝個 Git,學一下 commit、push、pull、merge,遇到衝突要手動解決"——這不是在幫他們,是在勸退他們。

有沒有一種可視化的方式,把 Git 的能力包在一個用戶友好的界面裏?讓版本管理、Skill 查找、衝突檢測這些事,變成點一下鼠標就能完成的操作。

我在Skill管理器裏,只要點開任意一個Skill,就能看到版本歷史按鈕,點擊一下,可以快速完成版本管理:

圖片

圖片


這就是 Skill Hub 的起點——給社羣裏的普通用戶,做一個他們真正用得起來的 Skill 管理器。

03

PART

讓 CC 搭第一版

想清楚要什麼之後,剩下的事交給 Claude Code。我描述需求,CC 寫代碼,中間遇到問題它自己調試。核心邏輯就三件事:掃描、展示、編輯

掃描覆蓋了能想到的所有位置:全局 Skill 目錄、插件目錄(遞歸)、註冊過的項目目錄、常見開發路徑(~/Documents~/Projects~/Developer……),甚至會往當前目錄的上面再掃三級。

一次掃描,100+個 Skill 全部聚合到一個頁面。每個 Skill 有名字、描述、來源(本地 / 插件 / 符號連結)、作用域(全局 / 項目)、最後修改時間。

展示可以按來源分組、按作用域分組、按項目篩選、按關鍵詞搜索。終於不用 find 了。

圖片


編輯直接在瀏覽器裏改 SKILL.md,保存就生效。而且每次保存前會自動拍一個版本快照——改壞了隨時回滾。不用學 Git,點一下"回退"就行。

一行命令啓動:

skill-hub

瀏覽器自動打開 localhost:3456,完事。

第一版解決了最核心的問題:看得見、找得到、改得了、退得回。

04

PART

發到社羣之後,需求才真正開始

第一版做完發到社羣之後,反饋來得很快。而且每一條都是我沒預料到的。

有人用 Codex,不只用 Claude Code。 我寫掃描器的時候只掃了 ~/.claude/skills,因為我自己只用 Claude Code。但社羣裏有人同時用 Codex、Cline、Warp,Skill 散落在完全不同的位置。

這不是"沒想到",是沒有使用場景就沒有感知

圖片


有人有兩台電腦。 Mac mini 在家當主力寫 Skill,MacBook Air 出門用。167 個 Skill,怎麼同步?

這個需求聽起來就是"上傳下載"。但一展開,全是決策點:

問題
為什麼難
衝突策略
兩邊都改了同一個 Skill,以誰為準?
增量 vs 全量
100+ 個 Skill 每次全量比對太慢,增量需要維護狀態
網絡異常
同步到一半斷了,部分寫入算不算髒數據?
多設備
不止兩台,可能台式機 + 筆記本 + 公司電腦
私有 Skill
有些 Skill 裏有 API key,要不要排除?

這些細節在 PPT 裏永遠不會出現。只有手沾泥巴的時候才會一個個撞上。


還有人說刪 Skill 能不能批量? 簡單但高頻。167 個 Skill 裏有不少試驗品,一個一個刪太痛苦。

圖片


每條反饋都變成了下一版功能。

05

PART

每條反饋都變成了下一版

基於這些反饋,密集迭代。批量刪除加回收站、衝突標記、啓用禁用開關這些都是常規操作,做了就有。

但有兩個功能值得展開說。

第一個是相似檢測

掃出來 167 個 Skill 之後我自己都嚇了一跳——我居然有好幾對"幾乎一樣"的 Skill。同一個功能,不同時間寫的,名字不同但內容重疊度 80%。社羣裏很多人也有這個問題:裝了七八十個 Skill,根本記不清哪些撞了。

所以加了基於關鍵詞的相似度檢測。自動把疑似重複的 Skill 聚類展示,支持中英文混合匹配。點進去能看兩個 Skill 的內容差異,決定保留哪個。相當於給你的 Skill 庫做了一次"體檢"

圖片


第二個是 Git 同步

多設備同步這個需求,我一開始想自己做一套 sync 協議。但馬上否掉了——衝突處理、增量傳輸、斷點續傳,每個展開都是一個工程。

然後我想到:這些問題 Git 全都解決過了。

最終方案是用 GitHub 私有倉庫當免費後端:

本地 Skill → git push → GitHub 私有倉庫 → git pull → 另一台設備

衝突處理交給 git merge,增量同步 git 天然只傳 diff,私有倉庫免費不用搭服務器。用戶只需要在界面上設一個倉庫地址加一個 Token,就能實現多端同步。Mac mini push,MacBook Air pull,不用懂一行 Git 命令。

圖片


把複雜度交給 Git,我只做上層體驗。這和搭知識庫的邏輯一樣——不是什麼都自己造,是找到好的基礎設施,在上面做好用戶看得見的那一層。

06

PART

需求不是想出來的,是用出來的

回過頭看這個項目,我覺得最值得記錄的不是功能列表,而是一個體感:

需求不是想出來的,是用出來的。

每一個"我沒想到"的功能——多平台掃描、相似檢測、多設備同步——都不是我坐在那裏想出來的。是真實用戶拿着他們的真實場景,幫我撞出來的。

在社羣裏教 Skill 的好處是,我離用戶足夠近。痛點不需要調研,不需要問卷,它們每天自己會冒出來。

做產品的第一步不是畫原型,是自己先用起來,然後丟給真實用戶。他們的使用習慣,就是最好的產品經理。


Skill Hub 現在開源了,一行命令就能用:

npm install -g https://github.com/Backtthefuture/skillmanager/raw/main/release/claude-skill-hub.tgz && skill-hub

整個倉庫放在:https://github.com/Backtthefuture/huangshu


如果你的 Claude Skill 超過了 20 個,你可能已經需要它了。

如無必要,勿增實體。基於這個原則,我並沒有去開發 Mac 版本,我覺得使用瀏覽器就足夠簡單了。如果不小心你把瀏覽器給關閉了,可以使用一行命令,在終端裏就能夠重新打開它。

skill-hub

我也做了期視頻介紹,歡迎大家查看: