mmd-debugging

Diagnose and fix MMD file issues through a structured debugging workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill provides a structured approach to identify, diagnose, and fix errors in MIDI Markdown (MMD) files, including syntax, timing, and validation failures.

Core Features & Use Cases

  • Systematic diagnostics: syntax checks, full validation, event inspection, and error categorization.
  • Troubleshooting workflows: quick guidance for common scenarios like "no MIDI output" or "timing issues" with clear steps.
  • Reproduction and debugging: create minimal reproductions and export diagnostics for external analysis.

Quick Start

Provide a minimal failing MMD file to begin debugging and validation.

Frequently Asked Questions about mmd-debugging

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

FAQPage Schema
How do I debug MIDI Markdown timing issues and syntax errors?▼

To debug MIDI Markdown timing issues and syntax errors, provide a minimal failing MMD file to initiate a structured workflow covering syntax checks, full validation, and event inspection to isolate defects.

What is the workflow for diagnosing validation failures in MMD files?▼

Diagnosing validation failures in MMD files involves a structured workflow: performing syntax checks, running full validation, inspecting events, and creating minimal reproductions to isolate and resolve defects.

Why does my MIDI Markdown file produce no MIDI output?▼

If your MIDI Markdown file produces no MIDI output, you can resolve it by following a troubleshooting workflow that includes syntax checks, validation, and event inspection to identify and fix the underlying defect.

Can I export diagnostics from a failing MIDI Markdown file for external analysis?▼

Yes, you can export diagnostics from a failing MIDI Markdown file for external analysis by creating a minimal reproduction and generating diagnostic commands to isolate the defect.

How do I fix import and alias issues in MIDI Markdown files?▼

To fix import and alias issues in MIDI Markdown files, use the structured debugging workflow to run full validation and event inspection, which isolates and resolves these specific configuration defects.