midnight-tooling:midnight-compatibility

Align Midnight compiler, runtime, and SDK versions against the support matrix.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/aaronbassett/midnight-knowledgebase --skill midnight-tooling-midnight-compatibility
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: midnight-tooling:midnight-compatibility
Source: https://github.com/aaronbassett/midnight-knowledgebase/tree/main/plugins/midnight-tooling/skills/midnight-compatibility
Command: npx skills add https://github.com/aaronbassett/midnight-knowledgebase --skill midnight-tooling-midnight-compatibility

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Midnight development often faces version-compatibility challenges across multiple components. This skill provides guidance to interpret version mappings, verify pragma language_version compatibility, and align compiler, runtime, and libraries to prevent runtime errors.

Core Features & Use Cases

  • Guidance on version mappings between compiler, runtime, and libraries.
  • Checks for pragma language_version compatibility and alignment with compiler versions.
  • Troubleshooting workflow for upgrades, dependency updates, and cross-component mismatches.

Quick Start

Run a compatibility check by aligning your contract pragma and compiler version with the Midnight support matrix and adjust versions as needed.

Frequently Asked Questions about midnight-tooling:midnight-compatibility

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

FAQPage Schema
How do I align Midnight compiler and runtime versions to fix dependency mismatches?

To align Midnight compiler and runtime versions, validate your project against the Midnight support matrix and enforce mapping rules between compiler versions, language versions, and runtime libraries to prevent compatibility issues.

Why does changing the pragma language_version cause runtime errors in Midnight?

Changing the pragma language_version causes runtime errors when the specified version lacks compatibility with the active Midnight compiler and runtime libraries, requiring alignment against the Midnight support matrix to resolve.

What is the Midnight support matrix used for during compiler upgrades?

The Midnight support matrix maps valid relationships between compiler versions, language versions, and runtime libraries, serving as a validation reference to ensure component alignment and prevent errors during compiler upgrades.

Can I use any compiler language_version with my current Midnight SDK dependencies?

You cannot use arbitrary compiler language_version values with current Midnight SDK dependencies; the compatibility skill verifies pragma language_version alignment and validates dependencies against the Midnight support matrix.

What is the best way to troubleshoot version mismatches across Midnight components?

The best way to troubleshoot Midnight version mismatches is running a compatibility check that aligns the contract pragma and compiler version with the Midnight support matrix and adjusts dependencies as needed.