SKILL.md
Agent Skills的核心配置文件，用于显式描述AI Agent的工作流程、参考文档路径、工具配置等，将模型行为锁定在可预期的执行路径上
核心事实
时间轴 (近 90 天)
SKILL.md 是一种基于纯文本的能力描述形式，轻量、可读、易于版本管理，不绑定特定运行时。
MCode Stack 仓库包含 17 个 SKILL.md 技能文件和 5 份检查清单（checklists）。
同一份 SKILL.md 可以被不同运行时加载，从而实现跨平台复用。
Claude-Red 将渗透测试、漏洞利用、EDR 规避、shellcode 编写等攻击性安全领域的专家方法论封装成结构化的 SKILL.md 文件。
SKILL.md 的文件格式和核心规范在移交后保持不变，现有项目中的 SKILL.md 文件不需要因为这次移交而立即修改。
标准移交后，开发者可能需要在 SKILL.md 中检查版本兼容性、元数据字段有效性（如维护方相关元信息）以及引用链接是否被重定向或迁移。
如果 SKILL.md 的 front matter 格式有误（如缺少分隔符、缩进错误、冒号后未加空格），解析可能失败，表现为 Skill 完全不被识别，而非仅仅匹配不准。
编写 SKILL.md 时，name 应保持简短、稳定、语义明确，避免含糊缩写；description 建议采用「动词 + 对象 + 场景」的句式，覆盖适用任务与不适用边界，必要时列出典型触发关键词。
SKILL.md 通常由 YAML 前置元数据与 Markdown 正文两部分构成。
Skills 文件夹内可以包含 scripts、references、assets 等子目录，也可以添加其他自定义文件夹，但必须在 SKILL.md 中明确指向，否则智能体无法做出基础判断。
还有 38 条时间轴事件
全部知识事实 (20)
skill.md使用Markdown格式编写，包含元信息（技能名称和描述）以及详细的执行指令
80%已验证一个完整的Skill包含Skill.md主文档、Reference文件夹、Script文件夹和Assets文件夹
80%已验证Agent Skills是Anthropic发布的能力封装标准，定义为一个包含Skill.md文件的目录，可包含说明、脚本和其他资源
80%已验证Skill本质上是Markdown文件，存储在项目的.claude/目录中
75%已验证SKILL.md 通常由 YAML 前置元数据与 Markdown 正文两部分构成。
70%已验证Skills 文件夹内可以包含 scripts、references、assets 等子目录，也可以添加其他自定义文件夹，但必须在 SKILL.md 中明确指向，否则智能体无法做出基础判断。
70%已验证Skill目录结构中，开发流程对应SKILL.md文件，参考文档对应references目录，开发工具对应scripts目录，静态资源对应assets目录
70%已验证代理运行时（Agent Runtime）是支撑 AI 代理持续运行、调用工具、维持状态并执行多步任务的底层基础设施，包含沙箱环境、文件系统访问控制、命令执行白名单以及跨会话的状态持久化机制等组件。
65%已验证Skill 的渐进式加载机制分两级：第一级只暴露 name 与 description 构成极小技能目录；第二级在命中后才把 SKILL.md 全文及支撑文件读入。
65%已验证SKILL.md 元数据中最少必须包含 name 和 description 两个字段
65%已验证SKILL.md 文件开头由三个横线包裹一段元数据（Frontmatter），这是 Skill 被 AI 工具识别的关键
65%已验证Skill 本质上是自然语言 Prompt，被放入名为 skill.md 的特殊文件中
65%已验证SKILL.md以Markdown文件描述Agent工具的能力边界、调用方式和使用约定，属于声明式能力描述
65%待验证一个Skills只需要包含一个SKILL.md文件就可以运行，其余组件（scripts、references、resources等）都是可选的
60%待验证SKILL.md 采用 Markdown 格式编写，文件顶部以 YAML Front Matter 或标题块承载元信息，包含 name、description、trigger 等字段
60%待验证SKILL.md 是一种基于纯文本的能力描述形式，轻量、可读、易于版本管理，不绑定特定运行时。
50%待验证MCode Stack 仓库包含 17 个 SKILL.md 技能文件和 5 份检查清单（checklists）。
50%待验证同一份 SKILL.md 可以被不同运行时加载，从而实现跨平台复用。
50%待验证Claude-Red 将渗透测试、漏洞利用、EDR 规避、shellcode 编写等攻击性安全领域的专家方法论封装成结构化的 SKILL.md 文件。
50%待验证标准移交后，开发者可能需要在 SKILL.md 中检查版本兼容性、元数据字段有效性（如维护方相关元信息）以及引用链接是否被重定向或迁移。
50%