write-migration-guide

Generate structured migration guides for breaking API, database, and library changes.

Updated Apr 1, 2026

Search Tags:#documentation #rollback #verification #migration #deprecation #migration-guide #breaking-change

Ready to run

npx skills add https://github.com/hpsgd/turtlestack --skill write-migration-guide

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-migration-guide
Source: https://github.com/hpsgd/turtlestack/tree/main/plugins/product/developer-docs-writer/skills/write-migration-guide
Command: npx skills add https://github.com/hpsgd/turtlestack --skill write-migration-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation for breaking changes is often inconsistent and hard to follow. This skill generates complete migration guides that align stakeholders, developers, and users around a clear path from old to new.

Core Features & Use Cases

Generate a structured migration guide with change summaries, before/after examples, rollback plan, and timeline.
Produce sections for impact assessment, step-by-step migration steps, breaking changes, coexistence strategy, and verification.
Tailor guides for API, database, or library upgrades across projects, teams, and ecosystems.

Quick Start

Provide the breaking change details and run the migration-guide writer with the given inputs.

Frequently Asked Questions about write-migration-guide

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

FAQPage Schema

How do I generate a migration guide for API breaking changes?▼

To generate a migration guide for API breaking changes, provide the change details to the Skill. It produces a structured document with impact assessment, before/after examples, step-by-step migration steps, and rollback plans.

What should be included in a database migration guide?▼

A database migration guide should include impact assessment, breaking changes, coexistence strategy, rollback plans, and verification steps. This Skill automates generating these sections with explicit code examples for old and new usage.

Can I use this to create a deprecation timeline for library upgrades?▼

Yes, you can create a deprecation timeline for library upgrades. The Skill generates template-based documents that include deprecation timelines, coexistence strategies, and step-by-step migration steps tailored for library upgrades.

What is the best way to document a rollback plan for software migrations?▼

The best way to document a rollback plan for software migrations is using a structured guide. This Skill automates creating rollback plans alongside impact assessment, verification steps, and before/after examples for breaking changes.

Does this migration guide generator support coexistence strategies?▼

Yes, this migration guide generator supports coexistence strategies. It produces structured guides covering impact assessment, breaking changes, coexistence, rollback, and verification for APIs, databases, and library upgrades.

How do I write verification steps for breaking changes?▼

To write verification steps for breaking changes, provide the change details to the Skill. It generates a structured guide including verification sections, ensuring alignment among stakeholders, developers, and users.