Skill607 repo starsupdated 18d ago

mda-compat-intro

The mda-compat-intro skill demonstrates that MDA-compiled SKILL.md files load successfully in Claude Code and that the agentskills.io v1 envelope fields are honored. Use this to verify MDA compilation compatibility and confirm that frontmatter metadata and allowed-tools configurations parse correctly in Claude Code environments.

View source Repository: mda

Install in Claude Code

Copy

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

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

Definition

SKILL.md

# MDA Compat Demo (Claude Code)

This skill exists to verify Claude Code SKILL.md compatibility from an MDA-compiled output.

Three things are true if you can see this skill listed in your Claude Code session:

1. The compiled `SKILL.md` parses under Claude Code's loader.
2. The frontmatter `name` matches the package directory name (spec §06-2.1).
3. The top-level `allowed-tools` field reaches Claude Code where it can be honored.

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

What this does NOT prove:

- That MDA today can author the runtime-specific Claude Code fields outside the agentskills.io v1 envelope (`when_to_use`, `model`, `effort`, `context`, `hooks`, `paths`, `shell`, `agent`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`). Those are out of v1.0 scope and earmarked for v1.1.
- That Claude Code parses MDA-extended frontmatter under `metadata.mda.*` (it does not, and is not required to).
- That signatures or integrity digests are checked at load (no current runtime does that).