技能介绍

解决的问题

在 SkillHub 上频繁上架原创 Skill 时，Agent 很容易重复踩坑：Slug 拼得太长导致校验失败，zip 包内路径使用了反斜杠引发安全告警，提交后没有到 dashboard 核对便以为成功，甚至对同一个 Skill 发起二次上传。这些问题并非来自平台不稳定，而是缺少一套固化的操作路径。本技能把已经验证过的上架流程沉淀下来，让 Agent 每次执行「做个 Skill 并上架」或「Slug 不可用」「上传后看板没有」这类请求时，不必重新摸索规则，直接按清单执行即可。

工作方式

技能的核心是五条底层硬规则，覆盖了上架全流程的决策点：

已上架禁止再传：只要 dashboard 或本地已发布清单中出现同名显示名，直接拒绝重传。
只上新原创：禁止整段照搬其他 Skill 的正文，确保内容独立。
成功标准唯一：仅以 dashboard「我的 Skills」中出现显示名为准，接口返回成功不代表上架完成。
间隔等待：两次上传之间随机等待 2～5 分钟，降低并发冲突概率。
首次变更说明留空：初次发布时变更说明字段保持空白，避免信息冗余。

在交付结构上，zip 包内的条目路径强制使用 /，形如 my-skill/SKILL.md。Slug 的生成遵循严格格式：小写字母 2–4 位 + 年份 + 3–4 位数字，总长度不超过 16，例如 oqh20268596。禁止使用长英文缩写加完整日期、demo/test 等占位词，也不允许出现连字符。上架前需先通过 check-slug 确认 available:true，并在 React 表单中用 onChange 实时写入校验结果。

网页上架阶段，技能内置了一份检查清单，覆盖文件选择、路径安全、接口回调等关键动作。常见的失败现象也被整理成速查表，例如 Slug 不可用时换短 slug 并确保 React 同步赋值后再提交，文件路径不安全时把 zip 内路径全部改为 /，遇到 setFiles 找不到 input 时先点击「本地上传」再操作，接口成功但看板未显示时优先翻页查找。

适用边界

本技能只服务于高频上架原创 Skill 的协作者，不适合用于上传第三方已有内容或修改已成功上架的 Skill。它提供的是一套防重、防错的流程约束，而不是自动发布脚本。Agent 在遇到上架失败时，允许换 slug 重试 1 次，但绝不可对已成功项再次发起上传。中文描述中必须写清「何时用」，汇报时需要明确显示名、slug 以及看板是否已确认。如果你只是偶尔上架一次，或者已经手工核对过所有规则，本技能的价值会相对有限。