前言¶
自己写的 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
