面向代理文档的Markdown超集。一个来源，多个目标——编译到每个主要代理运行时已经加载的.md文件中。加载时防篡改——每个工件都携带可复现的内容摘要，且签名工件带有Sigstore锚定签名，因此加载文档的代理和审核人员都不必信任未签名的blob。

阅读其他语言： 英语 ·中文 ·德语 ·西班牙语 ·法语 ·Русский ·한국어 ·日本語 ·हिन्दी

什么是MDA

到目前为止，你发布了同一个技能四次。一次作为SKILL.md用于 agentskills.io 运行时。一次作为AGENTS.md用于AAIF生态系统。一次作为MCP-SERVER.md，带有边车JSON。一次作为CLAUDE.md。内容相同，四个前置文件形状。更新一个，忘记其他，一个月后，这四个文件悄然变成了四个略有不同的指令文件。

你写一个.mda。编译器输出其余部分。

兼容性

写一次你的技能。它会直接插入每个主要代理运行时——保持不变。

五个 SKILL.md 运行时通过可复现的安装套件在compat/中端到端验证。编译的“代理。

📝 MDA Open Spec — Markdown for Agent

A Markdown superset for agent-facing documents. One source, many targets — compile into the .md files every major agent runtime already loads. Tamper-evident at load — every artifact carries a reproducible content digest, and signed artifacts carry Sigstore-anchored signatures, so neither the agent loading the doc nor the human reviewing it has to trust an unsigned blob.

Read in other languages: English · 中文 · Deutsch · Español · Français · Русский · 한국어 · 日本語 · हिन्दी

What MDA is

Until now, you shipped the same skill four times. Once as SKILL.md for the agentskills.io runtimes. Once as AGENTS.md for the AAIF ecosystem. Once as MCP-SERVER.md with a sidecar JSON. Once as CLAUDE.md. Same content, four frontmatter shapes. Update one, forget the others, and a month in, the four files have quietly drifted into four slightly different instruction files.

You write one .mda. The compiler emits the rest.

                ┌─────────────────────────┐
                │   .mda  (source)  │   ← MDA superset
                └────────────┬────────────┘
                             │  mda compile
                             ▼
   ┌─────────────────────────────────────────────────────────┐
   │ /SKILL.md     (+ scripts/, references/, assets/)  │
   │ AGENTS.md                                               │
   │ /MCP-SERVER.md  (+ mcp-server.json sidecar)       │
   │ CLAUDE.md                                               │
   └─────────────────────────────────────────────────────────┘
                       drop-in compatible

Compatibility

Write your skill once. It drops into every major agent runtime — unchanged.