What problem does it solve?
This Skill removes the error-prone manual process of updating a fork by automating fetch, preview, conflict handling, and the per-version migration chain required to stay compatible with upstream framework changes.
Core Features & Use Cases
- Upstream sync with safety gates: Fetches
upstream and origin, previews the commit delta, and then syncs via either merge (default) or rebase while refusing risky states (dirty tree, wrong branch, missing upstream remote).
- Release-aware migration handling: Detects whether migrations should run (tagged releases), supports a
--skip-migrations mode for files-only sync, and offers a controlled “update chain” when jumping multiple releases.
- Fork layout migration (split-portfolio v1 → v2): Detects pre-v2 split-portfolio adopters and offers an interactive, idempotent migration that copies onboarding, moves workspace contents, updates
.gitignore, writes the .apexyard-fork marker, and updates project-config.json.
Quick Start
Run the update as a merge-based sync to pull in the latest tagged upstream release and its required migrations: /update