# MDA — Compile One Doc into SKILL/AGENTS/CLAUDE > MDA is a Markdown superset for docs; verified 559★. One `.mda` compiles into SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md via `@markdown-ai/cli`. ## Install Save the content below to `.claude/skills/` or append to your `CLAUDE.md`: ## Quick Use ```bash npm install -g @markdown-ai/cli mda init hello-skill --out hello.mda mda validate hello.mda mda compile hello.mda --target SKILL.md AGENTS.md --out-dir out --integrity mda integrity verify out/SKILL.md --target SKILL.md ``` ## Intro MDA is a Markdown superset for docs; verified 559★. One `.mda` compiles into SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md via `@markdown-ai/cli`. **Best for:** Teams maintaining multiple agent doc formats that keep drifting out of sync **Works with:** agentskills.io SKILL.md, AAIF-style AGENTS.md, MCP-SERVER.md, and CLAUDE.md consumers; Node-based CLI workflows **Setup time:** 10-20 minutes ### Key facts (verified) - GitHub: 559 stars · 14 forks · pushed 2026-05-11. - License: Apache-2.0 · owner avatar + repo URL verified via GitHub API. - README-backed entrypoint: `npm install -g @markdown-ai/cli`. ## Main - Treat `.mda` as the single source of truth, then compile drop-in docs for multiple runtimes instead of duplicating content by hand. - Use `mda validate` and the target schemas as a CI gate so published SKILL/AGENTS/CLAUDE artifacts stay structurally correct. - Use integrity digests (`--integrity`) and `mda integrity verify` when you need tamper-evident docs in agent supply chains. ### Source-backed notes - README describes `.mda` as a Markdown superset that compiles into SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md outputs. - CLI manual states the npm package is `@markdown-ai/cli` and the installed binary/command is `mda`. - CLI manual shows a minimal flow: `mda init` → `mda validate` → `mda compile --integrity` → `mda integrity verify`. ### FAQ - **What command does the CLI install?**: The CLI manual says `@markdown-ai/cli` installs one command: `mda`. - **Can I run it without installing?**: Yes — CLI manual shows `npx @markdown-ai/cli --help` as a no-install entry point. - **What should I verify in CI?**: Validate both the `.mda` source and emitted targets, then run `mda integrity verify` for integrity checks. ## Source & Thanks > Source: https://github.com/sno-ai/mda > License: Apache-2.0 > GitHub stars: 559 · forks: 14 --- ## Quick Use ```bash npm install -g @markdown-ai/cli mda init hello-skill --out hello.mda mda validate hello.mda mda compile hello.mda --target SKILL.md AGENTS.md --out-dir out --integrity mda integrity verify out/SKILL.md --target SKILL.md ``` ## Intro MDA 是面向 agent 文档的 Markdown 超集；已验证 559★，并提供 `@markdown-ai/cli`，让一份 `.mda` 可编译为 SKILL.md、AGENTS.md、MCP-SERVER.md 与 CLAUDE.md。 **Best for:** 同时维护多种 agent 文档格式、经常发生漂移的团队 **Works with:** 兼容 agentskills.io 的 SKILL.md、AAIF 的 AGENTS.md、MCP-SERVER.md 与 CLAUDE.md 消费方式；基于 Node 的 CLI 工作流 **Setup time:** 10-20 minutes ### Key facts (verified) - GitHub：559 stars · 14 forks；最近更新 2026-05-11。 - 许可证：Apache-2.0；作者头像与仓库链接均已通过 GitHub API 复核。 - README 中可对照的入口命令：`npm install -g @markdown-ai/cli`。 ## Main - 把 `.mda` 作为单一事实来源，再编译出多种 runtime 可直接加载的文档，避免手动维护多份内容。 - 用 `mda validate` + 目标 schema 做 CI 门禁，保证发布的 SKILL/AGENTS/CLAUDE 结构始终正确。 - 当需要 agent 文档供应链的可验证性时，用 `--integrity` 生成摘要，并用 `mda integrity verify` 做校验。 ### Source-backed notes - README 将 `.mda` 定义为 Markdown 超集，可编译输出 SKILL.md、AGENTS.md、MCP-SERVER.md 与 CLAUDE.md。 - CLI 手册说明 npm 包名为 `@markdown-ai/cli`，全局安装后的命令为 `mda`。 - CLI 手册给出最小闭环：`mda init` → `mda validate` → `mda compile --integrity` → `mda integrity verify`。 ### FAQ - **CLI 安装后是什么命令？**：CLI 手册说明 `@markdown-ai/cli` 只提供一个命令：`mda`。 - **能不安装直接用吗？**：可以。CLI 手册提供 `npx @markdown-ai/cli --help` 的免安装用法。 - **CI 里应该验证什么？**：先校验 `.mda` 源文件与输出目标文件，再用 `mda integrity verify` 做完整性校验。 ## Source & Thanks > Source: https://github.com/sno-ai/mda > License: Apache-2.0 > GitHub stars: 559 · forks: 14 --- Source: https://tokrepo.com/en/workflows/mda-compile-one-doc-into-skill-agents-claude Author: Prompt Lab