osprey-migrate
Upgrades downstream OSPREY projects to newer versions. Applies API changes (method renames, class renames, import changes) from migration documents. Use when upgrading OSPREY version, migrating from old APIs, or when the user asks to upgrade, migrate, or update their OSPREY project.
When & Why to Use This Skill
The OSPREY Migration Assistant is a specialized Claude skill designed to automate the upgrading of downstream OSPREY projects. It streamlines the transition between software versions by automatically applying complex API changes, such as method renames, class updates, and import modifications, based on official migration documents. By providing a structured workflow—from version detection to dry-run reporting and final validation—it significantly reduces the manual effort and risk associated with framework migrations.
Use Cases
- Upgrading legacy OSPREY-based projects to the latest stable version to access new features and performance improvements.
- Automating repetitive refactoring tasks, such as renaming deprecated API methods or classes across a large codebase.
- Performing pre-migration impact assessments using dry-run reports to visualize code changes before they are committed.
- Ensuring code consistency and integrity after a version update by running automated validation commands and checks.
| name | osprey-migrate |
|---|---|
| description | > |
| allowed-tools | Read, Glob, Grep, Bash, Edit |
OSPREY Migration Assistant
This skill helps you upgrade your OSPREY-based project to a newer version.
Instructions
Follow the detailed migration workflow in instructions.md.
Data Files
- Migration documents: versions/ - YAML files describing changes for each version
- Schema: schema.yml - Migration document format specification
Quick Reference
- Ensure clean git state
- Detect current OSPREY version
- Load migration YAML for target version
- Show dry-run report of all changes
- Apply changes after user confirmation
- Run validation commands
- Provide summary and next steps