update

Synchronize an ops fork with upstream ApexYard releases via merge or rebase.

489|254|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/me2resh/apexyard --skill update-me2resh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update
Source: https://github.com/me2resh/apexyard/tree/main/.claude/skills/update
Command: npx skills add https://github.com/me2resh/apexyard --skill update-me2resh

SYSTEM DOCUMENTATION & REQUIREMENTS

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

Frequently Asked Questions about update

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a fork with upstream safely without losing local changes?

A safe fork sync validates git state, previews upstream commit deltas, and refuses risky operations on dirty trees or missing remotes, automating fetch and branch-based merge or rebase to protect local changes.

What is the best way to resolve conflicts during an upstream merge?

Conflict resolution during upstream merge is handled by automating branch-based merges or rebases with operator-controlled choices across per-version migration chains, ensuring deterministic framework update outcomes.

How do I handle database migration chains when jumping multiple upstream releases?

When jumping multiple upstream releases, the update process walks per-version migration chains sequentially, applying operator-controlled choices to ensure fork compatibility with required framework changes at each tagged release.

Can I skip migrations and only sync files when updating a fork?

Yes, you can skip migrations and sync only files by using the `--skip-migrations` mode, which bypasses release-aware migration handling and performs a files-only sync with the upstream repository.

Does git rebase work better than merge for syncing framework forks?

Git rebase is fully supported as an alternative to the default merge strategy for syncing framework forks, allowing operators to choose their preferred method while still enforcing safety gates like validating git state and resolving upstream refs.

Why does my fork update fail with a dirty tree or wrong branch?

Your fork update fails because safety gates refuse risky states like a dirty tree, wrong branch, or missing `upstream` remote, ensuring deterministic framework updates are only applied in a clean git state.