SKILL.md

结构与渐进披露

一个 Skill 是一个文件夹，入口是 SKILL.md。它的 frontmatter（name、description）始终在上下文里，让模型知道“有这么个技能、什么时候该用”；正文和附带的脚本 / 参考文件只有在技能被触发时才读入。这种分层（元数据常驻、细节按需）是为了在不撑爆上下文的前提下让模型拥有大量可选能力。

和 AGENTS.md 的区别

AGENTS.md 描述某个项目的规矩，随仓库走；SKILL.md 封装一种可跨项目复用的能力（如“生成 PPTX”“按公司风格写文案”），可安装、可分发。前者回答“在这个代码库里怎么干活”，后者回答“怎么做这类任务”。

常见误解

• description 字段不是摆设——它是模型判断“要不要用这个技能”的主要依据，写不好技能就不会被触发。
• Skill 不等于 MCP Server：Skill 是加载给模型的指令 / 资源，MCP Server 是外部服务。

相关术语

参考来源

1. Anthropic Engineering — Equipping agents for the real world with Agent Skills (2025)
2. Anthropic — Claude Docs: Agent Skills