Migration Guide Writer Skill

Purpose

Create comprehensive migration guides for moving from old systems/APIs to new ones. Follows the Diátaxis How-To pattern for problem-oriented documentation. Verifies all APIs in both old and new systems before documenting, with zero tolerance for fabrication.

Diátaxis Framework: How-To Guide

How-To Type Characteristics:

• Problem-oriented - Focused on specific migration goal
• Assumes knowledge - Not teaching from zero (that's tutorials)
• Series of steps - Path from old to new
• Multiple approaches - May show different migration strategies
• Real-world scenarios - Production migration patterns
• Troubleshooting - Common issues and solutions

What NOT to Include: