前言¶
自己寫的 Skill 往往只躺在本機或單一倉庫裏。若要同步到騰訊 SkillHub、蝦友 SkillHub、蝦聊、GitHub、ClawHub 等多個渠道，通常要逐平臺登錄、填表、打包，字段口徑也不一致，容易漏平臺或重複發佈。下面介紹社區 Skill Skill矩陣分發助手（座標 @user_ae5129cb/skill-matrix-publisher-free，當前版本 3.11.1），用一套流程把同一 Skill 做矩陣式分發，並在發佈前做命名、文案與安全打包上的硬校驗。
這是什麼¶
Skill矩陣分發助手（官方表述爲「統一版·免費/付費一版搞定」）是 SkillHub 社區發佈者 user_ae5129cb 維護的 ai-agent 類 Skill。它面向「同一 Skill 要多渠道曝光」的場景：在 API Key 單點認證 的前提下，按會員能力（canPublishPaidSkill）區分——付費會員可發佈定價 Skill（先用後付），免費用戶僅發佈免費 Skill。
官方頁面與 API 入口：
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_ae5129cb/skill-matrix-publisher-free
- API 資源：https://api.skillhub.cn/user_ae5129cb/skill-matrix-publisher-free
標籤 requires_api_key=true，發佈憑證由用戶在本機自行配置，官方說明爲僅存本機、不外傳；隨包不含賬號、密鑰與內部數據。
核心功能¶
以下能力均來自官方簡介，按發佈鏈路歸納。
六平臺一鍵分發¶
同一 Skill 逐平臺發佈，覆蓋騰訊 SkillHub（個人版 CLI + 團隊版 Web）、蝦友 SkillHub、蝦聊、GitHub、ClawHub 等，實現矩陣傳播。騰訊側發佈對標官方 CLI 契約，並處理 405 類問題；支持 coPublisher 聯名相關規則。
命名與文案硬閘¶
- 命名：展示名須中文主導；純英文或拼音全 ASCII 會被硬阻斷，進程以 exit 3 退出。
- 簡介與概述分欄：
subtitle爲標題下精簡一句話；description爲完整概述，兩字段各司其職、禁止混用。概述須少於 300 字；若簡介與概述整段相同，硬阻斷 exit 4。
安全合規打包¶
打包時排除密鑰、憑據與內部元數據，例如 config.json、.env、credentials、_meta.json 等，避免把敏感文件上傳到各平臺。
發佈流程防護¶
- 智能類目 / 自動歸檔，更新與發佈場景有冪等鎖，降低重複發佈。
- 發佈前探查：先檢索是否已有條目，搜不到才新建。
- 結果上報：零佔位、零 mock、零假成功；拿不到平臺回執即視爲失敗並如實上報。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。在 SkillHub 頁面給出的安裝方式是：讓當前 AI 按官方安裝文檔安裝本座標。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（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
安裝說明全文：https://skillhub.cn/install/skillhub.md
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝技能時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。
skillhub install user_ae5129cb/skill-matrix-publisher-free --dir <skills 目錄>
常用客戶端 skills 路徑（摘自官方安裝文檔，按你實際環境選擇）：
| 客戶端 | skills 目錄 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
也可在對話中直接提示 AI：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_ae5129cb/skill-matrix-publisher-free。」
3、配置 API Key¶
本 Skill 需要 API Key（requires_api_key=true）。具體環境變量或配置文件字段以 Skill 包內 SKILL.md 爲準；官方承諾發佈憑證只存本機。安裝完成後在 Agent 中啓用該 Skill，再按 Skill 內指引配置密鑰與平臺發佈憑證。
典型用法¶
官方未在頁面給出獨立 shell 示例，典型流程可理解爲：
- 在本地準備好符合 SKILL.md 規範的 Skill 目錄（展示名、subtitle、description 先按「命名與文案硬閘」自檢）。
- 在本機配置 SkillHub API Key 及各目標平臺所需發佈憑證。
- 在已啓用 Skill矩陣分發助手 的 Agent 中發起分發任務，由 Skill 按平臺順序執行發佈前探查、合規打包、逐平臺發佈。
- 根據 Agent 返回的各平臺回執判斷是否成功；若觸發 exit 3 / exit 4，按錯誤含義修正名稱或文案後重試。
經過上面的步驟，同一套元數據與包體可在多平臺對齊發布，而不必手工重複六套表單。
適用場景與注意¶
適合誰
- 維護自研或團隊 Skill，需要在騰訊 SkillHub 生態與 GitHub、ClawHub 等站外渠道同步曝光的作者。
- 希望發佈前自動攔掉純英文命名、簡介概述混寫、敏感文件誤傳等合規問題的開發者。
限制與注意
- 必須提供 API Key；免費賬號與付費會員的發佈能力由
canPublishPaidSkill區分，定價 Skill 僅對具備權限的賬號開放。 - 命名與概述規則是硬阻斷，不滿足會直接退出，需改文案而非忽略報錯。
- SkillHub 頁面統計（截至抓取）：評分 100000，下載 2809；安裝數在抓取快照中爲 0，以官網實時數據爲準。
- 多平臺憑證均需用戶自行準備並妥善保管；Skill 側強調零密鑰隨包上傳，但本機配置仍屬敏感信息。
結尾¶
Skill矩陣分發助手把「多平臺重複發佈」收斂爲一條 Agent 工作流：單 Key 認證、六平臺矩陣分發、發佈前探查與合規打包，並對命名和文案做可預期的硬校驗。若你正在做多渠道 Skill 運營，可從官方頁獲取最新版本與安裝提示：
https://www.skillhub.cn/skills/user_ae5129cb/skill-matrix-publisher-free
