# Mda Spec

> Use this skill when the user wants to create agent-facing documents using the MDA Open Spec — a Markdown superset that compiles to SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md.

- Skill: `javimosch/mda-spec` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/mda-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/mda-spec/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/mda-spec

---


# MDA Open Spec — Markdown Driven Agent Documents

MDA is a Markdown superset for agent-facing documents. One `.mda` source compiles to SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md.

## Installation
```bash
git clone https://github.com/sno-ai/mda.git
sc skills teach mda-spec:quickstart
```

## Key Features
- **Single Source** — Write once in .mda, compile to all agent document formats
- **JSON Schema Validated** — Ensures document correctness
- **Dependency Graph** — Typed relationships between documents
- **Sigstore Signatures** — Cryptographic verification of document provenance
- **AAIF Compatible** — Works with agentskills.io and AAIF runtimes

## Usage Prompts
- "Create an MDA document that compiles to both SKILL.md and AGENTS.md"
- "Validate my .mda file against the MDA schema"
- "Compile this MDA document for Claude Code and Codex"