用途：指导如何撰写或收紧技能（skill）与智能体（agent）的 description 字段，使模型在众多技能中能正确路由并加载目标技能。description 是每轮对话都常驻上下文窗口的“指针”，也是技能中唯一始终加载的部分，因此需要比正文更严格地精简。
主要能力：把 description 拆成两项任务。一是命名材料，用动词加对象开头，例如 Generate conventional commit messages from staged git diffs，随后停止，删去正文已承载的自我评价式句子。二是列出分支，用 Use when、Activates on、Triggers on 或 Apply when 等指令式措辞，具体点名应触发本技能的文件类型、命令与任务模式；每个分支只写一次，同义改写不算新分支。
使用方式：先确定是模型调用还是用户调用。模型调用时省略 disable-model-invocation，写完整分支列表与 Use this skill when... 指令；用户调用时设 disable-model-invocation: true，只写一行摘要、去掉触发条件。description 必须写成单行字符串，避免 YAML 多行指示符（>-、|-、>、|），否则 Claude Code 的技能索引器可能误解析。仅在 YAML 需要时加引号（含冒号、前导特殊字符或布尔字面量）。可用 uvx skilllint@latest check <file> 校验，并用 uvx skilllint@latest check --fix <file> 修复 YAML 问题。
适用场景：创建技能或智能体、description 含糊臃肿、frontmatter 解析失败、需要控制常驻上下文开销时。
限制：user-invocable 与 disable-model-invocation 仅适用于技能文件，智能体文件不含这两个字段，其 description 始终面向模型，需写完整分支列表。资料未提供具体长度上限数值与收费信息。