branch-sync

Synchronize a working branch with its source branch using merge or rebase.

19|2|Updated May 13, 2026
One-click install
npx skills add https://github.com/microsoft/upgrade-agent-plugins --skill branch-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-sync
Source: https://github.com/microsoft/upgrade-agent-plugins/tree/main/plugins/upgrade-agent/upgrade/skills/system/branch-sync
Command: npx skills add https://github.com/microsoft/upgrade-agent-plugins --skill branch-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of synchronizing the upgrade working branch with its source branch, ensuring a smooth merge-back process at the end of an upgrade.

Core Features & Use Cases

  • On-demand Sync: Allows users to sync the working branch with the source branch using merge or rebase based on user preference.
  • Automated Sync: Triggers sync automatically between tasks if specified in scenario instructions.
  • Conflict Resolution: Automatically resolves conflicts using upgrade context and rollback on failure.
  • Build Validation: Validates the working branch after sync with a build to ensure integrity.

Quick Start

Run 'sync' to initiate a manual sync with the source branch.

Frequently Asked Questions about branch-sync

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

FAQPage Schema
How do I sync my upgrade working branch with the source branch?

To sync your upgrade working branch, run the 'sync' command to initiate a manual merge or rebase with the source branch. This synchronizes the working branch, resolves conflicts using upgrade context, validates with a build, and rolls back automatically on failure.

When do I need to synchronize an upgrade working branch?

You need to synchronize an upgrade working branch when it diverges from the source branch, typically main, to ensure a smooth merge-back process at the end of an upgrade. Branch sync detects divergence and resolves conflicts to maintain branch integrity.

Can I automatically trigger a branch sync between upgrade tasks?

Yes, you can automatically trigger a branch sync between tasks by specifying it in the scenario instructions. This automated sync synchronizes the working branch using merge or rebase, resolves conflicts using upgrade context, and validates the build automatically.

What is the best way to handle merge conflicts during a branch upgrade?

The best way to handle merge conflicts during a branch upgrade is to use a sync workflow that automatically resolves conflicts using upgrade context. If conflict resolution fails, the system rolls back the changes to maintain branch stability.

Does branch sync validate the build after merging changes?

Yes, branch sync validates the working branch with a build after synchronizing to ensure integrity. If the build validation fails, the system automatically rolls back the branch changes to prevent breaking the source branch.

Should I use merge or rebase to keep my upgrade branch updated?

You can choose either merge or rebase to keep your upgrade branch updated based on your preference. Both methods detect divergence, resolve conflicts using upgrade context, validate with a build, and roll back on failure to ensure a smooth merge-back process.