Osprey Migrate

---
name: osprey-migrate
description: >
  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.
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](../../../tasks/migrate/instructions.md).

## Data Files

- **Migration documents**: [versions/](../../../tasks/migrate/versions/) - YAML files describing changes for each version
- **Schema**: [schema.yml](../../../tasks/migrate/schema.yml) - Migration document format specification

## Quick Reference

1. Ensure clean git state
2. Detect current OSPREY version
3. Load migration YAML for target version
4. Show dry-run report of all changes
5. Apply changes after user confirmation
6. Run validation commands
7. Provide summary and next steps

## Setup

Before starting, run the environment preparation script:

```bash
python scripts/upgrade_helper.py
```

This ensures your shell environment is compatible with the latest migration tools.