new-export-version

Create a new game export schema version, migration module, and tests.

64|8|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/GregorStocks/mage-bench --skill new-export-version
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-export-version
Source: https://github.com/GregorStocks/mage-bench/tree/main/.claude/skills/new-export-version
Command: npx skills add https://github.com/GregorStocks/mage-bench --skill new-export-version

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates introducing a new game export schema version, its migration module, and corresponding tests to ensure forward and backward compatibility.

Core Features & Use Cases

  • Define a new per-version schema file (game-export-vN.schema.json) and its migration logic.
  • Update tests to validate schema validation and migration round-trips.
  • Coordinate version bumps across export producers, loaders, and migrations to maintain compatibility.

Quick Start

Create a new export version by implementing the schema, migration, and tests, then run the full test suite.

Frequently Asked Questions about new-export-version

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

FAQPage Schema
How do I automate game export schema versioning and migration creation?

Game export schema versioning is automated by generating a new per-version schema file, its migration module, and associated tests to enforce backward compatibility. This coordinates version bumps across export producers, loaders, and migrations.

What is the process for adding a new game export format version?

Adding a new game export format version involves defining a versioned schema file, writing the migration logic, and updating test coverage. This ensures forward compatibility when evolving the export format during development workflows.

How do I maintain backward compatibility when updating a game export schema?

Backward compatibility for game export schemas is maintained by generating dedicated migration scripts alongside new schema versions. Migration logic handles data transformation, while updated tests validate schema rules and migration round-trips.

Does this export migration workflow integrate with existing schema validation tests?

The export migration workflow integrates with existing tooling by enforcing versioned schema handling and test coverage checks. It coordinates with schemas, migration scripts, and puppeteer tests to validate schema changes and migration round-trips.

When should I create a new export version with migrations instead of modifying the current schema?

Create a new export version with migrations when evolving the export format requires preserving backward compatibility for previously exported games. Modifying the current schema directly risks breaking existing exports without dedicated migration logic.