Skill发布大师

要解决的问题

Skill 的源码写好了，不代表它能被用上。标题写成「图片处理工具」这类模糊表达，用户在搜索结果里根本判断不出这是干什么的；description 只是几句功能罗列，搜索引擎抓不到关键词；图标缺失或随手画一个，详情页完全没有辨识度。更麻烦的是发布环节：要自己拼图标上传接口的请求、再调发布接口传 iconUrl，token 从 ~/.skillhub/credentials.json 读取，Slug 还不能带空格和大写，任何一个字段写错都发布失败。@user_783c668f/my-skill-publisher 就是把这一串琐碎步骤固化成可复用流程的工具。

核心能力与关键步骤

1. 定位澄清：写任何文案之前先回答三个问题——解决什么问题、谁会用、触发词是什么。

2. SKILL.md 编写与元信息优化：这是整个技能里最重的一环。

• 标题遵循「功能动词 + 对象名词，6–10 字」，如 照片转扫描件、PDF合并拆分，拒绝「工具」「助手」这类模糊词
• description 控制在 150–300 字，前 50 字必须包含核心关键词与主要触发词，再用「当用户说……时触发」的句式覆盖 5–8 种表达方式
• 明确输入输出，突出算法或模型等技术亮点

3. 图标生成：调用脚本后按 category 自动配色——图像处理走蓝绿渐变配相机符号，办公效率走蓝色渐变配文档符号，金融数据走金红渐变配图表符号，输出 512x512 PNG。

4. 发布与版本更新：脚本依次读取 token、解析 frontmatter、生成图标、通过 POST /api/v1/skills/{slug}/comments/images 上传 CDN，最后 POST /api/v1/community/skills/publish 带上 iconUrl 发布。更新时改 version 字段并指定新版本号与 changelog，Slug 已存在则覆盖旧版本。

适用边界与注意点

• 它只管创建与发布，不负责安装（用 skillhub install）、搜索（用 skillhub search）或企业源管理
• 发布频率限制约每 30 秒 1 次，脚本内置冷却；遇到 429 等待后重试即可
• Token 格式为 skh_ 前缀，走 Authorization: Bearer 头
• 版本号必须是 SemVer（x.y.z），changelog 用自然语言写，slug 不能含空格或大写