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.