Is this skill specific to MIDI 2.0?

While designed for the midi2 repository, the methodology of mapping PDF-based protocol facts to JSON schemas is a best practice for any complex protocol implementation.

How does this skill process PDF documentation?

It renders specific PDF pages into images, allowing for a detailed inspection of technical bit layouts and field definitions to ensure the schema matches the visual specification exactly.

Why update the schema before writing code?

Updating the schema/OpenAPI first ensures that all generated code and tests align with a verified, structured definition, preventing logic errors and protocol mismatches.

Which files does this skill primarily modify?

The skill focuses on updating midi2.full.closed.schema.json and midi2.full.openapi.json to serve as the canonical source of truth for the project.

MIDI Specification Schema Mapper

Name: MIDI Specification Schema Mapper
Author: Fountain-Coach

byFountain-Coach

0•

API Development

Transforms protocol details from MIDI specification PDFs into canonical JSON schema and OpenAPI definitions for high-fidelity implementation.

The spec-pdf-to-schema skill automates the process of translating official MIDI association specification PDFs into structured, machine-readable formats. By rendering PDF pages into images for visual verification, it ensures that bit layouts and field definitions are accurately reflected in midi2.full.closed.schema.json and midi2.full.openapi.json. This workflow enforces a 'schema-first' development approach, ensuring that all subsequent Swift code and unit tests remain perfectly synchronized with the official protocol facts while maintaining a clear audit trail back to the source documentation.

Key Features

010 GitHub stars

02Updates canonical JSON schema and OpenAPI definitions automatically

03Renders MIDI PDF pages to images for precise bit-layout verification

04Maintains audit documentation linking schemas to specific PDF sections

05Synchronizes code and tests with verified protocol sources

06Ensures MIDI 2.0 implementation accuracy through visual inspection steps

Use Cases

01Implementing new MIDI 2.0 protocol features from official PDF specifications

02Validating internal data models against official bit-field definitions

03Updating existing OpenAPI definitions to reflect changes in MIDI standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fountain-coach/midi2 spec-pdf-to-schema

For use in Claude.ai and ChatGPT

Download Skill