Agent Skills
返回列表
💻

SkillHub 发布与操作规范

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3e3a3cf5/skillhub-publisher-user-3e3a3cf5。

技能介绍

要解决什么问题

不少人在本地已经写好带 SKILL.md 的 skill 目录,却不知道如何在腾讯 SkillHub(skillhub.cn)上完成登录、云端发布与后续更新。更麻烦的是,网上还有科大讯飞版 skill.xfyun.cn 的 npm @astron-team/skillhub,命令与 Token 互不通用,误装后 401、连错平台都很常见。本技能把官方流程浓缩成可执行步骤:实名与 API Key 前置、skillhub dry-run 预检、发布与 slug 不变 的更新,以及对外共享时的安装方式说明。

技能如何工作

全流程依赖腾讯官方 SkillHub CLI(非 npm 讯飞版)。硬性前置有三项:账号注册、网页端实名认证(未实名无法建 Token、也无法发布,403 多为此)、在「个人中心 → API keys」创建 skh_xxx 并当场保存。典型路径为:安装 CLI → skillhub login 校验 userId/handle/role → 确认 skill 根目录有 SKILL.md 与合规 frontmatter(slug、name、version、displayName、summary 等)→ dry-run 本地预检 → skillhub publish 进入 pending_review → 审核通过后他人可用 skillhub search/install 或网页访问。

技能还强调发布包安全:API Key 用 os.environ.get,禁止把 token/密钥写进 skill 包;更新发布须保持同一 slug。

适用边界与注意点

仅当用户明确要操作腾讯 skillhub.cn 时适用。用户要的是讯飞 SkillHub、纯本地整理文件、或 GitHub/工蜂/CNB 等托管平台时,不要用本技能。常见排错:未 source ~/.zshrc 导致 command not found;409 slug 冲突需改成带 handle 的全网唯一名;429 限频等待约一分钟;详情页「未找到」多为审核中,到「我的 Skill」看状态。

使用场景

  • 本地 skill 目录已就绪,需要首次发布到 skillhub.cn 并进入审核流程
  • 已发布 skill 要改 version 和 summary,但 slug 不能变,需要走更新发布
  • 智能体被要求「用 API key 登录 SkillHub」时,需要对照官方 CLI 步骤而非 npm 讯飞版
  • 发布前 SKILL.md frontmatter 报错,需要用 dry-run 在本地补齐 slug 等字段

适合人员

  • 维护自有 skill 仓库、要把同一套内容同步到 SkillHub 社区的独立开发者
  • 在企业内写 Agent skill、需按平台要求做实名、Token 与发布预检的 MLOps/平台工程师
  • 给团队写发布 SOP、必须区分腾讯 CLI 与讯飞 npm 包的两套环境的技能运营
  • 审核被拒或 403/409 频发、需要按错误码对照实名、slug、限频的 SkillHub 发布者