Skip to main content

SKILL.md

在 Agent Skills 标准中，SKILL.md是技能（Skill）的核心定义文件。

Agent Skills 是 Anthropic 推出的一个开放标准，用于给 AI 智能体（agents）提供模块化的专长能力。它已被 GitHub Copilot、VS Code、Claude Code 等多个平台采用。

SKILL.md 的具体作用​

  • 它是 Skill 唯一必备文件：每个 Skill 是一个独立的文件夹，里面必须包含一个名为 SKILL.md 的 Markdown 文件。

  • 包含元数据和指令：

    • 文件开头使用 YAML frontmatter 定义技能的 name（名称）和 description（描述），这些元数据会在代理启动时预加载，帮助 AI 判断何时使用该技能。

    • 文件主体是 Markdown 格式的详细指令：包括技能的目的、步骤指南、最佳实践、输出格式、错误处理等。AI 代理在判断任务相关时，会动态加载这个文件的内容到上下文中。

  • 支持渐进式加载（Progressive Disclosure）：代理先只看到简短描述，只有任务匹配时才读取完整 SKILL.md 和其引用的其他文件（如 scripts/、references/ 等），避免上下文窗口浪费。

  • 可选扩展：技能文件夹里可以附加脚本、模板、参考文档等，但核心行为都由 SKILL.md 定义和引用。

简单来说，SKILL.md 就是“技能的使用手册”，它教 AI 代理如何专业地完成特定任务（如代码审查、数据分析、表单填写等），让通用代理变成领域专家，而无需每次重复提示。