mda-compat-opencode
The mda-compat-opencode skill validates that MDA-compiled SKILL.md files are discoverable and parseable by OpenCode, confirming correct frontmatter structure and field preservation through the compilation pipeline. Use this to verify MDA output compatibility with OpenCode's skill loader and confirm that essential fields like name, description, license, compatibility, and metadata survive the round-trip from source to runtime.
git clone --depth 1 https://github.com/sno-ai/mda /tmp/mda-compat-opencode && cp -r /tmp/mda-compat-opencode/compat/opencode/build ~/.claude/skills/mda-compat-opencodeSKILL.md
# MDA Compat Demo (OpenCode) This skill exists to verify OpenCode SKILL.md compatibility from an MDA-compiled output. Three things are true if OpenCode discovers and loads this skill: 1. The compiled `SKILL.md` parses under OpenCode's loader. 2. The frontmatter `name` matches the package directory name (spec §06-2.1 and OpenCode's own naming rules). 3. The five documented top-level fields (`name`, `description`, `license`, `compatibility`, `metadata`) plus MDA's `integrity` survive the round-trip from `.mda` source to compiled output to runtime ingest. Source: `compat/opencode/source.mda`. Compile: `mda compile compat/opencode/source.mda --target SKILL.md --out-dir compat/opencode/build --integrity`. What this does NOT prove: - That OpenCode parses MDA-extended frontmatter under `metadata.mda.*` (the OpenCode docs do not document any such behavior, and we do not require it; per docs "unknown frontmatter fields are ignored", so passthrough is safe). - That signatures or integrity digests are verified at load time (no current runtime does that). - That `allowed-tools` is honored — OpenCode's public docs do not list this field. MDA may emit it (agentskills.io v1 envelope), but OpenCode's behavior on it is undocumented.
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 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`.
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.