Skill607 repo starsupdated 18d ago

mda-compat-hermes

The mda-compat-hermes skill verifies that Hermes Agent can discover and parse MDA-compiled SKILL.md files. Use this skill to confirm that MDA source code compiles into valid Hermes-compatible skill definitions with correct frontmatter naming and metadata namespace preservation through the compilation pipeline.

View source Repository: mda

Install in Claude Code

Copy

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

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

Definition

SKILL.md

# MDA Compat Demo (Hermes Agent)

This skill exists to verify Hermes Agent SKILL.md compatibility from an MDA-compiled output.

Three things are true if Hermes discovers and loads this skill:

1. The compiled `SKILL.md` parses under Hermes Agent's loader.
2. The frontmatter `name` matches the package directory name (spec §06-2.1).
3. The agentskills.io v1 envelope subset survives the round-trip from `.mda` source to compiled output to Hermes' skill registry; the reserved `metadata.hermes.*` namespace passes through verbatim for Hermes' own consumption.

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

What this does NOT prove:

- That Hermes 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 Hermes-specific top-level fields (`version`, `author`) that some existing Hermes skills carry at top level rather than under `metadata.mda.*`. Those are out of MDA v1.0 scope under §06-3.4, symmetric with the Claude Code runtime-fields gap.