Updated 4mo ago
by sno-ai
mda
MDA Open Spec — a Markdown superset for agent-facing documents. One .mda source compiles to drop-in SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md. JSON Schema validated, with typed dependency graph, footnote relationships, and Sigstore-anchored signatures. For agentskills.io and AAIF runtimes.
621 GitHub stars (621)
+4 in 20 days
| Period | New stars |
|---|---|
| Sep 27 | 0 |
| Sep 28 | 0 |
| Sep 29 | 0 |
| Sep 30 | 0 |
| Oct 1 | 0 |
| Oct 2 | +1 |
| Oct 3 | +1 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | −1 |
| Oct 7 | +1 |
| Oct 8 | +1 |
| Oct 9 | 0 |
| Oct 10 | 0 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | +1 |
- 8 skills (8 skills found in its SKILL.md files)
- 33 forks (33 forks)
- 4mo ago last update (Last updated 4mo ago)
Install
Skills CLI
npx skills add sno-ai/mda
Asks which skills and agents to install. Just one: npx skills add sno-ai/mda --skill mda-compat-intro — add -g for every project.
Claude Code
git clone https://github.com/sno-ai/mdacp -r "mda/compat/claude-code/build" ~/.claude/skills/
Copies the mda-compat-intro skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add sno-ai/mda
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
mda-compat-intro
MDA compatibility demonstration skill for Claude Code. Compiled from compat/claude-code/source.mda. Loading this skill confirms that an MDA-emitted SKILL.md loads in Claude Code with the envelope subset of agentskills.io v1 fields honored.
compat/claude-code/build/SKILL.md on GitHub (opens in a new tab) -
mda-compat-codex-cli
MDA compatibility demonstration skill for Codex CLI. Compiled from compat/codex-cli/source.mda. Loading this skill confirms that an MDA-emitted SKILL.md is discovered and parsed by Codex CLI with the envelope subset of agentskills.io v1 fields honored.
compat/codex-cli/build/SKILL.md on GitHub (opens in a new tab) -
mda-compat-hermes
MDA compatibility demonstration skill for Hermes Agent. Compiled from compat/hermes/source.mda. Loading this skill confirms that an MDA-emitted SKILL.md is discovered, parsed, and listed by Hermes Agent under its `~/.hermes/skills/<category>/<name>/SKILL.md` layout.
compat/hermes/build/SKILL.md on GitHub (opens in a new tab) -
mda-compat-openclaw
MDA compatibility demonstration skill for OpenClaw. Compiled from compat/openclaw/source.mda. Loading this skill confirms that an MDA-emitted SKILL.md installs cleanly via `openclaw skills install <local-dir> --global` and is reported as parsed by `openclaw skills info --json`.
compat/openclaw/build/SKILL.md on GitHub (opens in a new tab) -
mda-compat-opencode
MDA compatibility demonstration skill for OpenCode. Compiled from compat/opencode/source.mda. Loading this skill confirms that an MDA-emitted SKILL.md is discovered and parsed by OpenCode with the envelope subset of fields documented at opencode.ai/docs/skills/ honored.
compat/opencode/build/SKILL.md on GitHub (opens in a new tab) -
intro-example
Minimal MDA source demonstrating relationship-graph footnotes and metadata.mda.* MDA-extended fields. Use as a reference fixture when learning the MDA source format.
examples/skill-md/intro/SKILL.md on GitHub (opens in a new tab) -
node-tools
Run a TypeScript script via tsx to fetch an HTTP endpoint and stream the response. Use when you need a small Node.js helper for HTTP calls.
examples/skill-md/node-tools/SKILL.md on GitHub (opens in a new tab) -
compile-basic
Basic compiler conformance fixture.
conformance/compile/46-basic-targets/expected/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.