技能介绍

要解决什么问题

在 Marvis / SkillHub 上写 Agent Skill 时，常见问题不是「缺一段 prompt」，而是 触发不准（该用时没加载）、SKILL.md 超长 挤占上下文、以及 name / description / 目录结构 不符合 Anthropic 约定导致校验失败。本技能把 anthropics/skills 与 agentskills.io 的语义整理成可执行的写作与迭代基线，并说明与 Marvis 发布格式的差异。

技能如何工作

核心模型是 渐进式披露：L1 仅 name + description（约 100 tokens），L2 为激活时加载的 SKILL.md 正文（建议 500 行以内），L3 为 scripts/、references/、assets/ 按需加载。规范速查覆盖 name 约束（小写、连字符、与目录名一致）、description 的双维度写法（做什么 + 何时用，宁可略宽触发）、以及一级深度的相对路径引用。

创建流程强调四问基线（能力边界、触发短语、输出格式、是否需可验证测试），再按祈使句写指令、定义输出格式，并用 2～3 条真实用户 prompt 做冒烟。优化循环侧重 undertrigger：补文件名模式（.pdf、.docx）、具体意图表述与否定边界；质量维度包括触发、指令清晰度、边界、Token 预算与可验证性。§6 汇总 17 个官方示例技能 的模式（任务-方案表、Gotchas、验证自检、脚本清单），§7 提供从零模板，§8 对照 Marvis 与 Anthropic 在触发、references 拆分、脚本执行与发布上的差异。

适用边界

自举哨兵：当你被要求设计/评估/改进 Skill 但未显式加载本技能时，仍应回顾 §2 规范与 §3 方法论作为默认基线。
文档类官方技能（docx/pdf/pptx/xlsx）在 Anthropic 侧部分 源可用但非全开源；本技能提供触发关键词与模式总结，不替代各技能仓库内的实现细节。
§5 禁止恶意代码、误导性描述与未授权访问类设计；纯人格「角色扮演」不鼓励用 Skill 承载。