SkillHub 创作规范
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d544ba0e/skillhub-authoring。
技能介绍
要解决的痛点
不少作者在 SkillHub 上写的技能仍像「给人看的教材」:教程式叙述、一个 Skill 包好几件事、description 里没写清何时触发。结果是 AI 不会主动加载,评测里 trigger、boundary、errorHandling 频频扣分,离 5 分发布很远。
这套规范怎么帮你写对
规范的核心是 AI-Native:技能应解决「AI 自己做不了什么」,用指令式步骤和固定的输入→输出格式,而不是「首先…然后…建议…」。
- description 硬性项:末尾必须带
TRIGGER/INPUT/OUTPUT三类标签,评测会据此检测触发映射。 - 五维评测:
adaptability(边界 + 双语触发词 + 与同类型 Skill 区分)、convention(反模式 FAQ、多场景完整示例、knowledge/或references/模块化)、effectiveness、reliability(≥3 种降级场景文案)、trust(全中文、国内直连、无外部 API)。 - SKILL.md 骨架:触发方式 → 能力边界 → 错误处理 → 使用方式 → FAQ → 反模式 → 文件结构;书单类另需
knowledge/逐条原则(编号、引用、案例等)。
边界与易踩坑
✅ 适合:在 SkillHub 从零设计或改版单职责技能、对照子项名(如 antiPatternFaq、structure)补材料、发布前用 skillhub publish --dry-run 查 slug。
❌ 不是:通用 Prompt 写作课、或非 SkillHub 平台的技能分发说明。连续无间隔发布会触发频率限制;单一巨型 SKILL.md 无子目录时,structure 最高约 4.0。
使用场景
- 准备首次在 SkillHub 发布 Agent 技能,需要按五维标准搭好 SKILL.md 与 description 标签
- 评测反馈 trigger、boundary 偏低,要补双语触发词和「不能做什么」的具体场景说明
- 想把一个包罗万象的旧 Skill 拆成多个单一职责技能,并对照反模式清单自检
- 做孙子兵法/书单类技能,要按规范建 knowledge/ 目录与每条原则的引用与案例格式
适合人员
- 已在 SkillHub 注册作者、准备提交 v1 却不知道怎么写 TRIGGER/INPUT/OUTPUT 的工程师
- 收到 devil's-advocate 类评测明细、要逐项对照 boundary、errorHandling 改稿的内容维护者
- 运营站内技能库、需要统一团队 SKILL.md 章节与 knowledge/ 模板的平台协作者
- 想参考 5 分样例(如批判性评审类 Skill)复制结构而非照抄文案的中文技能作者