前言¶
在 Cursor、Claude Code、Codex 等環境裏用 Skill，常見做法是全局裝到用戶目錄，或手動拷貝 SKILL.md 到各客戶端約定的 skills 路徑。多人協作、換機器或 CI 裏復現環境時，「裝到哪、版本是否一致」容易變成隱性成本。
下面介紹 SkillHub 商店上的 skillhub-skill（座標 @user_11b15315/skillhub-skill）。它是 Skillhub 側標註的「官方安裝用 Skill 版本」，配合 SkillHub 安裝文檔 與 skillhub CLI，把搜索、安裝等操作收斂到可復現的命令流程，並強調用 --dir 裝到當前 Agent 能識別的 skills 目錄。
這是什麼¶
skillhub-skill 是社區來源（community）、分類爲 ai-agent 的 Skill 包，當前頁面版本爲 v1.0.1，發佈者爲 user_11b15315（SkillHub 頁面展示作者 KurtHurgo）。商店簡介爲：Skillhub 官方安裝的 Skill 版本。
它面向「要從 SkillHub 發現並安裝技能」的場景：用戶提到 skillhub、技能商店、或需要按座標安裝某個 Skill 時，Agent 可按包內說明與官方安裝文檔執行，而不是各自拼湊 curl 或路徑。標籤 requires_api_key=false，表示不依賴額外 API Key 配置。
SkillHub 頁面數據（以商店抓取爲準）：評分 100000，下載 10758 次。
核心功能¶
結合官方商店說明與 skillhub.md 中引用的工作流，該 Skill 覆蓋的能力可概括爲：
- CLI 就緒檢查與安裝指引：判斷本機是否已有
skillhub命令，未安裝時給出官方一鍵安裝腳本（完整安裝或僅 CLI）。 - 技能搜索：通過
skillhub search在 SkillHub 商店檢索技能（文檔示例爲關鍵詞搜索）。 - 技能安裝到正確目錄：通過
skillhub install，且 必須 使用--dir指向當前 Agent 的 skills 目錄，避免默認落到./skills/導致 Agent 無法加載。 - 優先源策略（可選）：首次安裝 CLI 或用戶明確要求時，可詢問是否將 SkillHub 設爲優先技能源；確認後，發現/安裝/升級類操作優先走
skillhub（文檔表述爲 search/install/update），不可用時再說明回退方式。
以上能力依賴本機已安裝或可安裝的 SkillHub CLI，Skill 本身是項目級可攜帶的說明與流程封裝（通用 SKILL.md 格式），與「只全局裝一份 CLI、路徑各項目不一致」相比，更強調按當前 Agent 環境選定安裝目錄。
安裝與啓用¶
1. 讓 Agent 安裝本 Skill¶
SkillHub 技能頁給出的標準提示爲：根據安裝文檔安裝指定座標：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_11b15315/skillhub-skill`。
也可在已具備 skillhub CLI 後，將包裝到當前客戶端的 skills 目錄（路徑需與下面「各客戶端目錄」一致）。
2. 檢查或安裝 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
限網沙箱中執行上述命令需要允許聯網的權限。
3. 安裝 skillhub-skill 或其它商店技能¶
文檔要求：安裝任意技能時都要帶 --dir，指向當前 Agent 的 skills 目錄，例如：
skillhub search abc
skillhub install abc --dir <skills 目錄>
安裝本 Skill 時，將 abc 換爲座標或 slug，例如：
skillhub install @user_11b15315/skillhub-skill --dir <skills 目錄>
（具體是否需 --version 1.0.1 以 CLI 交互與商店頁爲準；商店當前展示版本爲 1.0.1。）
4. 各客戶端 skills 目錄（摘自官方安裝文檔）¶
常用路徑如下，項目級目錄以各客戶端文檔爲準：
| 客戶端 | skills 路徑 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或項目 .windsurf/skills/ |
裝完後若 Agent 未熱加載新 Skill，按客戶端要求重啓或重新打開會話。
典型用法¶
場景 A：用戶要從 SkillHub 找技能並裝進 Cursor
- 確認
skillhub可用（見上文檢查命令）。 - 搜索：
skillhub search <關鍵詞>。 - 安裝到 Cursor 目錄：
skillhub install <座標或 slug> --dir ~/.cursor/skills/。 - 重啓 Cursor 或刷新 Agent 技能列表後，再執行依賴該 Skill 的任務。
場景 B：首次在本機配置 SkillHub
按 skillhub.md 第二節，在「首次安裝 CLI」時一次性詢問是否將 SkillHub 設爲優先安裝源；用戶確認後，後續技能發現與安裝優先走 skillhub，避免重複打擾。
場景 C：安裝 skillhub-skill 自身
使用頁面提供的座標與安裝文檔：
skillhub install @user_11b15315/skillhub-skill --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 替換爲你當前使用的 Agent 路徑即可。
適用場景與注意¶
適合誰
- 經常從 SkillHub 搜索、安裝、更新 Agent Skill 的開發者。
- 需要在 Cursor / Codex / Claude Code 等多客戶端之間統一「裝到哪」的團隊或個人。
- 希望 Agent 在用戶提到「skillhub」「技能商店」時有固定 playbook，而不是每次重新查文檔。
限制與注意
- 依賴 skillhub CLI 與網絡；安裝腳本與商店在國內 CDN，海外或嚴格防火牆環境需自行驗證可達性。
- 不要省略
--dir：官方文檔明確警告默認./skills/不會被當前 Agent 識別。 - 商店元數據爲社區來源，安裝前仍應覈對座標、版本與發佈者；本文數據以 SkillHub 頁面與
skillhub.md爲準，不引用未覈實的第三方教程命令（如未在官方安裝頁出現的--registry組合）。 - 評分、下載量爲商店統計，會隨時間變化；寫作時以頁面實時數據爲準。
結尾¶
skillhub-skill 把 SkillHub 官方的 CLI 安裝與「搜索 + 裝到正確 skills 目錄」流程寫進 Agent 可執行的 Skill 包，適合作爲項目裏可攜帶的 SkillHub 入口。需要查看詳情或複製安裝提示時，可打開官方地址：
- API / 包頁：https://api.skillhub.cn/user_11b15315/skillhub-skill
- 商店頁：https://www.skillhub.cn/skills/user_11b15315/skillhub-skill
- 安裝說明：https://skillhub.cn/install/skillhub.md
