用途：当你需要创建、编辑、审查或调试 agent 的 SKILL.md 文件，或需要关于触发条件、示例、限制与安全说明的质量指引时使用。它系统性整理了 agent 技能是什么、为何存在、如何工作以及如何写好。
技能构成：一个 Agent Skill 是一个包含 SKILL.md 的文件夹，SKILL.md 由 YAML frontmatter 加 markdown 指令组成，可选配 scripts/（可执行代码）、references/（按需加载的详细文档）、assets/（模板、字体等静态文件）。该标准为开放标准（agentskills.io），最初由 Anthropic 创建，已被 OpenAI Codex、Cursor、Gemini CLI、Microsoft Agent Framework、Google ADK 等 40 多个 agent 产品采用，写一次可跨兼容 agent 使用。
工作原理（渐进式披露三级加载）：一级发现，启动时仅将 frontmatter 的 name 与 description（约 100 token/技能）注入系统提示，agent 知道技能存在及适用时机，可低开销安装多个技能；二级激活，当用户请求匹配 description 时将完整 SKILL.md 正文读入上下文（少于 5000 token）；三级执行，按需读取引用文件或运行脚本，脚本无需将源码载入上下文即可执行，因此打包内容几乎无实际上限。
写法要点：frontmatter 的 name 用小写、仅连字符、1–64 字符，且与父文件夹名完全一致；避免在 frontmatter 中使用 < 和 >；无效 YAML 会静默导致加载失败。可选字段 disable-model-invocation: true 可禁止自动加载、仅允许手动触发（如 /skill-name），但部分客户端仍会注入 description。正文建议包含 Quick start、Workflow、Output format、Advanced 等分段。
两种设计哲学：能力原语（工具包装）以确定性 CLI 或脚本承载逻辑，SKILL.md 教 agent 如何调用，通常 30–80 行，多为命令示例，瓶颈在 agent 不会做某事时使用；过程原语（认知纪律）编码方法论，纯提示工程，无需脚本，用于结构化工作流。限制与更多细节：暂未提供。