用途:本技能聚焦 SKILL.md 的撰写,指导如何让 Claude Code 技能被可靠加载并高效传达信息。若涉及智能体编写或插件架构,则属于其他技能的范畴。
主要能力:一是把 description 当作触发机制而非摘要,要求包含 3 个以上动作型触发短语,以“Use when…”或“How to…”开头,并显式写出工具或框架名,且能对应真实用户提问。二是正文结构,按范围说明、最常用模式、决策矩阵、改造示例、常见错误、参考资料排序;H1 仅作标题,H2 用编号大节,H3 作子节,不跳级。三是代码示例需先示问题再给方案,可运行、有上下文、只注释关键行。四是渐进式披露,SKILL.md 控制在 500 行内,把完整 API 参考、边缘场景、大配置矩阵、示例与脚本放入 references/、examples/、scripts/ 目录。
使用方式:编写时先列出 3 个以上真实用户查询并映射为触发短语;按节组织正文;对每个代码示例标注问题与解决;超出 500 行的内容外移到引用文件;发布前逐项核对质量清单,包括触发短语数量、范围说明、标题层级、问题/方案示例、A 与 B 决策表、总行数、是否包含模型已掌握的理论、是否至少有一个改造前后示例。
适用场景:创建、改进或审查 Claude Code 技能时使用。
限制:资料未提供具体安装命令、收费方式或平台支持范围;技能质量评分与行数上限为文中给出的建议标准,并非强制约束。