Agent Skills
返回列表
🤖

SkillHub 创作规范

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 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)复制结构而非照抄文案的中文技能作者