branch-sync Skill
On-demand sync of the upgrade working branch with its source branch (typically main) using merge or rebase. Detects divergence, resolves conflicts using upgrade context (prefer upgraded code in files we changed, prefer source elsewhere), validates with a build, and rolls back on any failure. Trigger phrases: "sync", "s Published by microsoft in upgrade-agent-plugins.
What is branch-sync Skill?
On-demand sync of the upgrade working branch with its source branch (typically main) using merge or rebase. Detects divergence, resolves conflicts using upgrade context (prefer upgraded code in files we changed, prefer source elsewhere), validates with a build, and rolls back on any failure. Trigger phrases: "sync", "s Published by microsoft in upgrade-agent-plugins. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.
Automated repository signals based on public metadata such as recency, license, installation evidence, and adoption. These are not a security audit or endorsement.
Key capabilities
- Includes SKILL.md support
- Reusable instructions support
- Developers using upgrade-agent-plugins
Technical details
- Install or run with Copy skill directory
When to use branch-sync Skill
- Use it for developers using upgrade-agent-plugins.
Built with
Editorial notes
Source
- Creator: microsoft
- Repository: microsoft/upgrade-agent-plugins
- Skill file: plugins/upgrade-agent/upgrade/skills/system/branch-sync/SKILL.md
What it does
On-demand sync of the upgrade working branch with its source branch (typically main) using merge or rebase. Detects divergence, resolves conflicts using upgrade context (prefer upgraded code in files we changed, prefer source elsewhere), validates with a build, and rolls back on any failure. Trigger phrases: "sync", "s
Skill instructions
Branch Sync Guide Keeps the upgrade working branch close to its source branch so merge-back at the end of a long upgrade is incremental rather than catastrophic. The skill is invoked two ways: - On demand \u2014 when the user says "sync with main", "merge from main", "rebase on main", etc. - Automatically between tasks \u2014 by the task-execution skill (\u00a76.5) when the persisted Branch Sync strategy in scenario-instructions.md is Auto (Merge) or Auto (Rebase). Both paths run the same lifecycle below. Safety invariants (read before any git command) - No push, ever. This skill never executes git push in any form (push, push --force, push --force-with-lease). Pushing the working branch — especially after a rebase, which rewrites history — is the user's decision and tooling. If a future change appears to require pushing, stop and surface the situation to the user instead. - Source-branch refs are read-only. The skill only updates the working branch's HEAD. It must never run git branch
Explore related resources
Frequently asked questions
What is branch-sync?
branch-sync is a open-source AI agent skill with Copy skill directory. On-demand sync of the upgrade working branch with its source branch (typically main) using merge or rebase.
Who is branch-sync best for?
branch-sync is best for reusing agent instructions, scripts, and references.
How do I install branch-sync?
Install or run branch-sync using Copy skill directory. Check branch-sync for the latest setup command.
Is branch-sync actively maintained?
branch-sync may need a closer maintenance check before production use.
Auto-fetched from GitHub.
