mda-compat-openclaw
The mda-compat-openclaw skill is a compatibility verification tool that confirms MDA-compiled SKILL.md files install and parse correctly in OpenClaw. Use it to validate that the MDA compiler generates valid OpenClaw skill manifests with proper frontmatter structure and metadata preservation through the compilation pipeline.
git clone --depth 1 https://github.com/sno-ai/mda /tmp/mda-compat-openclaw && cp -r /tmp/mda-compat-openclaw/compat/openclaw/build ~/.claude/skills/mda-compat-openclawSKILL.md
# MDA Compat Demo (OpenClaw) This skill exists to verify OpenClaw SKILL.md compatibility from an MDA-compiled output. Three things are true if OpenClaw discovers and loads this skill: 1. `openclaw skills install <dir> --global` accepts the MDA-emitted file. 2. The frontmatter `name` matches the package directory name (spec §06-2.1). 3. The agentskills.io v1 envelope subset (`name`, `description`) survives the round-trip from `.mda` source to compiled output to OpenClaw's managed plugin-skills directory. Source: `compat/openclaw/source.mda`. Compile: `mda compile compat/openclaw/source.mda --target SKILL.md --out-dir compat/openclaw/build --integrity`. What this does NOT prove: - That OpenClaw parses MDA-extended frontmatter under `metadata.mda.*` (we do not require it). - That signatures or integrity digests are verified at load time (no current runtime does that). - That MDA v1.0 can author OpenClaw-specific top-level fields (e.g. `user-invocable`, which one shipped OpenClaw skill carries at top level). Those are out of MDA v1.0 scope under §06-3.4, symmetric with the Claude Code runtime-fields gap.
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.
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.
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.
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.
Basic compiler conformance fixture.
Minimal MDA source demonstrating relationship-graph footnotes and metadata.mda.* MDA-extended fields. Use as a reference fixture when learning the MDA source format.
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.