upstream-sync

Track upstream commits and port changes into a Git fork.

25|1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ShiroiKuma0/shiroikumanojisho --skill upstream-sync-shiroikuma0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upstream-sync
Source: https://github.com/ShiroiKuma0/shiroikumanojisho/tree/main/.claude/skills/upstream-sync
Command: npx skills add https://github.com/ShiroiKuma0/shiroikumanojisho --skill upstream-sync-shiroikuma0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps forks aligned with upstream by tracking changes, identifying port-worthy updates, and applying them with provenance so your fork remains current and maintainable.

Core Features & Use Cases

  • Remote upstream tracking: add and manage an upstream remote, compare commits, and determine port boundaries.
  • Selective porting workflow: cherry-pick or manually port changes with clear provenance and changelog notes.
  • Changelog and tagging: record sync points with upstream-sync-X.Y.Z and annotate ported changes for future audits.

Quick Start

Run the upstream-sync workflow to fetch, review, and port upstream changes into your fork.

Frequently Asked Questions about upstream-sync

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

FAQPage Schema
How do I keep my git fork up-to-date with upstream changes?

To keep your git fork up-to-date with upstream changes, you can track an upstream remote, compare commits to identify port boundaries, and selectively cherry-pick or manually port updates with clear provenance.

What is the best way to cherry-pick upstream commits into a fork while maintaining a changelog?

The best way to cherry-pick upstream commits into a fork while maintaining a changelog is to use a selective porting workflow that annotates ported changes and records sync points with upstream-sync tags for future audits.

Do I need a specific git repository setup to track upstream releases for porting fixes?

Yes, tracking upstream releases for porting fixes requires a Git repository with a configured upstream remote, a defined upstream-sync tagging convention, and a documented porting workflow for commit attribution.

How does provenance work when porting fixes from an upstream remote into a fork?

Provenance when porting fixes from an upstream remote into a fork works by documenting commit attribution and annotating ported changes in the changelog, ensuring every cherry-picked or manually ported update is traceable to its original source.

Can I selectively port only specific upstream changes instead of merging the entire branch?

Yes, you can selectively port only specific upstream changes instead of merging an entire branch by evaluating tracked commits to determine port boundaries, then applying only the port-worthy updates via cherry-pick or manual porting.

Why should I use upstream-sync tags when monitoring upstream releases for my fork?

You should use upstream-sync tags when monitoring upstream releases for your fork because they record exact sync points, providing a documented history of ported fixes and enabling accurate future audits of upstream parity.