What problem does it solve?
This Skill prevents risky, downtime-causing migrations by guiding a safe, staged transfer of a single Django project from one VPS to another within the fleet.
Core Features & Use Cases
- Three-gate migration workflow: supports
--check (preflight dry-run), --apply (clone + setup + snapshot + transfer without stopping origin), and --cutover --confirm-downtime (stop origin, finalize delta dump, start target, and guide DNS flip).
- Per-project migration using fleet environment controls: performs migration by composing the existing scripts with
FORCE_SINGLE_PROJECT and FORCE_PROJECTS, rather than migrating an entire VPS.
- Host-aware invocation: detects whether you’re running from a dev workstation, the target VPS, or the origin VPS, and aborts when invoked from the origin to reduce operational risk.
- Operational safety during cutover: includes smoke tests and a commit of the
projects.yml flip, with an explicit downtime target (≤5 min HTTP / ~0 min with SSL blue-green).
Quick Start
Run the migrate-project skill in apply mode for your project and target VPS by executing: migrate-project <project_name> <target_vps_alias> --apply.