エージェント向けドキュメント用のMarkdownスーパーセット。一つのソース、多くのターゲット — すべての主要なエージェントランタイムがすでにロードしている.mdファイルにコンパイルする。ロード時に改ざん防止 — すべてのアーティファクトは再現可能なコンテンツダイジェストを持ち、署名されたアーティファクトはSigstoreアンカの署名を持つため、ドキュメントを読み込むエージェントもそれをレビューする人間も署名されていないブロブを信用する必要がない。

他言語で読む: 英語 ·中文 ·ドイツ語・スペイン語 ·フランス語 ·Русский ·한국어 ·日本語 ·हिन्दी

MDAとは何か

これまで同じスキルを4回リリースしましたね。1回は agentskills.io ランタイム用にSKILL.mdとして。AAIFエコシステム用にAGENTS.mdとして。サイドカーJSONでMCP-SERVER.mdとして。1回はCLAUDE.md。同じ内容で、4つのフロントマター形状。1つを更新し、他は忘れ、1ヶ月後には4つのファイルが静かに4つの少し異なる命令ファイルに流れてしまいました。

1つ.mdaを書きます。コンパイラが残りを出力します。

相性

スキルを一度書く。それはすべての主要なエージェントのランタイムに反映される — 変更なし。

5つの SKILL.md ランタイムがcompat/の再現可能なインストールキットでエンドツーエンドで検証されました。コンパイルされた「AGENTS.」

📝 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.