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.

javimosch f8f7099 1.1 KB Updated

File contents

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

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"

javimosch/supercli/tree/main/plugins/mda-spec/skills/quickstart commit f8f709979f

Frequently asked questions

npx skillmds@latest add javimosch/mda-spec