up-to-date

Sync local git repositories with upstream or origin main branches.

1|1|Updated Jan 26, 2025
One-click install
npx skills add https://github.com/idvorkin/chop-conventions --skill up-to-date
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: up-to-date
Source: https://github.com/idvorkin/chop-conventions/tree/main/skills/up-to-date
Command: npx skills add https://github.com/idvorkin/chop-conventions --skill up-to-date

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you keep your local repository in perfect alignment with its upstream source, eliminating drift, reducing merge conflicts, and saving you time at the start of a session or when a repo becomes stale.

Core Features & Use Cases

  • Remote awareness: Detects whether an upstream remote exists and identifies the canonical source (upstream/main or origin/main).
  • Automated syncing: Pulls from the correct source to bring your local branch up to date.
  • PR status awareness: Checks pull request status on feature branches and handles merging or syncing as appropriate.
  • Safe operations: Reports uncommitted changes and untracked files, and advises user actions rather than overwriting work.
  • Use Case: At project kickoff, run this Skill to ensure you're working from the latest code and that any pending PRs are accounted for, minimizing surprises during development.

Quick Start

Run the up-to-date skill at the start of your session to detect the remote setup, fetch updates from the appropriate main branch (upstream/main or origin/main), and report behind/ahead status and PR state. If you have a fork with an upstream, the Skill will pull from upstream and push the latest main to origin to keep your fork in sync.