mmd-writing

Create and validate MIDI Markdown files with correct syntax and timing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Writing MIDI Markdown (MMD) files can be error-prone due to strict frontmatter, timing, and command rules. This skill provides clear guidance to write correct MMD files and troubleshoot common syntax issues.

Core Features & Use Cases

  • Validates and guides frontmatter setup (ppq, tempo, time_signature) and common MMD conventions.
  • Supports the full MMD feature set including absolute, musical, relative, and simultaneous timing, plus imports, loops, sweeps, randomization, and modulation.
  • Helps users write, edit, debug, and troubleshoot MMD files and automate device workflows across multiple device libraries.

Quick Start

Create an MMD file that begins with YAML frontmatter and a first timing marker to start sequencing MIDI events.

Frequently Asked Questions about mmd-writing

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

FAQPage Schema
How do I write MIDI Markdown files with correct frontmatter and timing?

Writing MIDI Markdown files requires valid YAML frontmatter with ppq, tempo, and time_signature parameters, followed by a first timing marker to sequence MIDI events correctly and avoid common syntax errors in device automation workflows.

What timing paradigms does MIDI Markdown support for sequencing events?

MIDI Markdown supports four timing paradigms: absolute, musical, relative, and simultaneous timing. These allow precise control over event sequencing, enabling complex automation patterns across multiple device libraries with flexible scheduling options.

Can I use loops, sweeps, and modulation in MIDI Markdown configurations?

Yes, MIDI Markdown supports loops, sweeps, random values, and modulation as advanced features. These enable dynamic device automation by repeating event sequences, sweeping parameter ranges, introducing randomized values, and modulating control changes across device libraries.

Why does my MIDI Markdown file fail frontmatter validation?

MIDI Markdown frontmatter validation fails when required fields like ppq, tempo, or time_signature are missing or incorrectly formatted. The file must begin with valid YAML frontmatter and include a first timing marker before any MIDI event definitions.

Does MIDI Markdown support importing devices from external libraries?

Yes, MIDI Markdown supports device imports from multiple device libraries. This allows you to reference and automate external device definitions within your MMD files, enabling cross-library workflow automation and modular configuration management.

What is the best way to troubleshoot syntax errors in MIDI Markdown files?

The best way to troubleshoot MIDI Markdown syntax errors is to validate frontmatter presence, check timing marker placement, verify command syntax against MMD conventions, and ensure all timing paradigms, imports, loops, and modulation directives follow correct formatting rules.