home / skills / jeremylongshore / claude-code-plugins-plus-skills / migrating-apis
/plugins/api-development/api-migration-tool/skills/migrating-apis
This skill automates API migrations across versions and platforms, guiding design, implementation, and testing to minimize downtime.
npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill migrating-apisReview the files below or copy the command above to add this skill to your agents.
---
name: migrating-apis
description: |
Implement API migrations between versions, platforms, or frameworks with minimal downtime.
Use when upgrading APIs between versions.
Trigger with phrases like "migrate the API", "upgrade API version", or "migrate to new API".
allowed-tools: Read, Write, Edit, Grep, Glob, Bash(api:migrate-*)
version: 1.0.0
author: Jeremy Longshore <[email protected]>
license: MIT
---
# Migrating Apis
## Overview
This skill provides automated assistance for api migration tool tasks.
This skill provides automated assistance for the described functionality.
## Prerequisites
Before using this skill, ensure you have:
- API design specifications or requirements documented
- Development environment with necessary frameworks installed
- Database or backend services accessible for integration
- Authentication and authorization strategies defined
- Testing tools and environments configured
## Instructions
1. Use Read tool to examine existing API specifications from {baseDir}/api-specs/
2. Define resource models, endpoints, and HTTP methods
3. Document request/response schemas and data types
4. Identify authentication and authorization requirements
5. Plan error handling and validation strategies
1. Generate boilerplate code using Bash(api:migrate-*) with framework scaffolding
2. Implement endpoint handlers with business logic
3. Add input validation and schema enforcement
4. Integrate authentication and authorization middleware
5. Configure database connections and ORM models
1. Write integration tests covering all endpoints
See `{baseDir}/references/implementation.md` for detailed implementation guide.
## Output
- `{baseDir}/src/routes/` - Endpoint route definitions
- `{baseDir}/src/controllers/` - Business logic handlers
- `{baseDir}/src/models/` - Data models and schemas
- `{baseDir}/src/middleware/` - Authentication, validation, logging
- `{baseDir}/src/config/` - Configuration and environment variables
- OpenAPI 3.0 specification with complete endpoint definitions
## Error Handling
See `{baseDir}/references/errors.md` for comprehensive error handling.
## Examples
See `{baseDir}/references/examples.md` for detailed examples.
## Resources
- Express.js and Fastify for Node.js APIs
- Flask and FastAPI for Python APIs
- Spring Boot for Java APIs
- Gin and Echo for Go APIs
- OpenAPI Specification 3.0+ for API documentation
This skill automates API migrations between versions, platforms, or frameworks with minimal downtime. It guides specification analysis, scaffolds code, implements handlers and middleware, and generates OpenAPI documentation. The goal is a predictable, testable migration path that preserves contracts and reduces production risk.
The skill inspects existing API specifications and resource models, then generates scaffolding for routes, controllers, models, and middleware. It applies validation, authentication hooks, database integrations, and produces OpenAPI 3.0 output. Migration steps include generating boilerplate, implementing business logic, adding tests, and preparing deployment patterns (blue/green or canary).
How does this skill minimize downtime during migration?
It recommends blue/green or canary deployments, feature flags, and running both old and new routes in parallel while re-routing traffic gradually.
What testing is included or recommended?
Run contract tests, integration tests for all endpoints, and end-to-end tests in a staging environment that mirrors production. Automate tests in CI/CD.