BAIZE AI RESOURCE

为 AI Agent 扩展专业能力与工作流的开放 SKILL.md 格式标准

SKILL.md

为 AI Agent 扩展专业能力与工作流的开放 SKILL.md 格式标准

获取资源
SKILL.md

资源介绍

Agent Skills 是一套轻量、开放的格式标准，用于为 AI Agent 扩展专业知识和可复用工作流。其核心是一个包含 SKILL.md 文件的文件夹：该文件至少包含 name 和 description 元数据，以及告诉 Agent 如何完成特定任务的指令；技能还可以附带脚本、参考资料、模板等资源。

Agent 通过“渐进式披露”分三阶段加载技能：启动时只读取每个技能的名称和描述，判断相关性；当任务匹配某个技能描述时，才把完整的 SKILL.md 指令读入上下文；随后按指令执行，必要时运行捆绑代码或加载引用文件。这样 Agent 可以同时持有大量技能而只占用很小的上下文。

该格式最初由 Anthropic 开发并作为开放标准发布，已被众多 AI 工具和 Agent 客户端采用。仓库同时提供规范文档、技能创建指南（快速上手、最佳实践、描述优化、脚本使用、技能评估）以及 Python 参考库 skills-ref，后者提供 validate、read-properties、to-prompt 等命令，用于校验技能目录、读取技能属性并生成供 Agent 系统提示使用的 XML。它适合希望把团队或企业专有流程沉淀为可移植、可版本控制资产的开发者与 Agent 使用者。

Skill 能力

SKILL.md 开放格式

技能以文件夹形式组织，核心是包含 name 与 description 元数据及任务指令的 SKILL.md，可选带 scripts、references、assets 等目录。

渐进式披露加载

Agent 启动时只加载技能名称和描述，任务匹配后才读入完整指令，执行时再按需运行捆绑代码或加载引用文件，控制上下文占用。

skills-ref 参考库

skills-ref

技能创建文档

docs 目录包含快速上手、最佳实践、描述优化、脚本使用与技能评估等指南，以及格式规范 specification.mdx。

跨客户端复用

技能构建一次即可在任意兼容该格式的 Agent 客户端中使用，仓库文档收录了大量已支持该格式的客户端。

资源配置

适用平台

Claude CodeClaudeCodexCursorGemini CLI通用 Agent

支持模型

模型无关

调用方式

自动触发命令调用Agent调用

安装与调用

  1. 为一个具体任务创建独立技能目录，并在其中编写 SKILL.md；需要时再加入脚本、模板或参考资料。

  2. 把技能目录安装到目标 Agent 支持的 Skills 路径，或通过其技能管理方式启用。

  3. 在对话中提出符合技能触发条件的任务，Agent 会先读取简要说明，再按需加载细节文件。

  4. 通过实际任务验证触发条件、步骤和输出，不断收紧说明，避免把无关背景长期放入上下文。

使用案例

校验技能目录

使用场景技能发布前检查格式合规性

执行 skills-ref validate path/to/skill，返回校验发现的问题列表；Python 中可用 validate(Path("my-skill")) 获取同样结果。

生成 Agent 可用技能提示

使用场景把多个技能接入 Agent 系统提示

执行 skills-ref to-prompt path/to/skill-a path/to/skill-b，生成包含 name、description、location 的 XML 块，location 指向完整 SKILL.md 路径。

读取技能属性

使用场景程序化获取技能名称与描述

执行 skills-ref read-properties path/to/skill 输出 JSON，或使用 read_properties(Path("my-skill")) 读取 props.name 与 props.description。

包含内容

skill-md-source.zip
README-中文安装说明.md
LICENSE-Apache-2.0.txt
THIRD-PARTY-NOTICES.md
SHA256.txt