mmd-cli

Compile MIDI Markdown files into MIDI with validation and playback.

2|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/cjgdev/midi-markdown --skill mmd-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mmd-cli
Source: https://github.com/cjgdev/midi-markdown/tree/main/.claude/skills/mmd-cli
Command: npx skills add https://github.com/cjgdev/midi-markdown --skill mmd-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables musicians and developers to compile, validate, inspect, and playback MIDI Markdown (MMD) files from a command-line interface, simplifying automation and integration into workflows.

Core Features & Use Cases

  • Compile MMD to MIDI with mmdc compile and export formats (MIDI, JSON, CSV, table) for downstream processing.
  • Validate syntax and perform quick checks with mmdc validate and mmdc check, catching errors before playback or export.
  • Real-time playback and inspection via the TUI, plus device library management via library commands to organize aliases and instruments.
  • Workflow examples include development loops, batch processing, and debugging TIMING and events.

Quick Start

Install mmdc and run mmdc compile song.mmd -o song.mid to generate a MIDI file.

Frequently Asked Questions about mmd-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compile MIDI Markdown files into standard MIDI format?

Compile MIDI Markdown (MMD) files into MIDI format by running the command line interface with the compile command, specifying the input MMD file and an output path to generate a standard MIDI file.

How do I validate MIDI Markdown syntax before playback or export?

Validate MIDI Markdown syntax using the dedicated validate and check commands to catch structural errors and debug timing issues before attempting real-time playback or exporting to downstream formats.

What output formats are supported when exporting compiled MIDI Markdown?

Exporting compiled MIDI Markdown supports multiple output formats including standard MIDI, JSON, CSV, and table formats, enabling downstream processing and integration into various development and batch automation workflows.

Can I manage instrument aliases and device libraries from the command line?

Device library management is supported through dedicated library commands, allowing users to organize instrument aliases and manage device configurations directly within the command line workflow for live performance or development.

Does the MIDI Markdown CLI provide real-time playback and inspection capabilities?

Real-time playback and inspection of MIDI Markdown files is provided through a text-based user interface, enabling interactive debugging of timing and events during live performance preparation and development loops.

What is the best way to automate batch processing of MIDI Markdown files?

Automate batch processing of MIDI Markdown files by integrating the deterministic command line interface into scripts, leveraging compile and validate commands to process multiple MMD files and export them to MIDI or JSON.