Skill607 repo starsupdated 18d ago

mda-compat-codex-cli

The mda-compat-codex-cli skill validates that MDA-compiled SKILL.md files are discoverable and parseable by Codex CLI using the agentskills.io v1 envelope specification. Use this skill to confirm that MDA source files compile to valid frontmatter matching package directory names and that core metadata fields survive the full compilation and runtime ingestion pipeline.

View source Repository: mda

Install in Claude Code

Copy

git clone --depth 1 https://github.com/sno-ai/mda /tmp/mda-compat-codex-cli && cp -r /tmp/mda-compat-codex-cli/compat/codex-cli/build ~/.claude/skills/mda-compat-codex-cli

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# MDA Compat Demo (Codex CLI)

This skill exists to verify Codex CLI SKILL.md compatibility from an MDA-compiled output.

Three things are true if Codex CLI discovers and loads this skill:

1. The compiled `SKILL.md` parses under Codex CLI's loader (built on agentskills.io v1).
2. The frontmatter `name` matches the package directory name (spec §06-2.1).
3. The agentskills.io v1 envelope subset (`name`, `description`, `allowed-tools`) survives the round-trip from `.mda` source to compiled output to runtime ingest.

Source: `compat/codex-cli/source.mda`. Compile: `mda compile compat/codex-cli/source.mda --target SKILL.md --out-dir compat/codex-cli/build --integrity`.

What this does NOT prove:

- That Codex CLI parses MDA-extended frontmatter under `metadata.mda.*` (the OpenAI docs do not document any such behavior, and we do not require it).
- That signatures or integrity digests are verified at load time (no current runtime does that).
- That non-standard top-level fields observed in some shipped Codex skills (for example `triggers:` arrays) are authored from MDA — they are not part of agentskills.io v1 and are out of MDA v1.0 scope.