pulling-updates-from-skills-repository

Updating Skills from Upstream

Overview

Pull and merge upstream changes from obra/superpowers-skills into your local skills repository while preserving your personal modifications.

Announce at start: "I'm using the Updating Skills skill to sync with upstream."

Prerequisites

Your skills repo must have a tracking branch configured. The plugin sets this up automatically (either as a fork with origin remote, or with an upstream remote).

The Process

Step 1: Check Current Status

Run:

cd ~/.config/superpowers/skills
git status

If working directory is dirty: Proceed to Step 2 (stash changes) If clean: Skip to Step 3

Step 2: Stash Uncommitted Changes (if needed)

Run:

git stash push -m "Temporary stash before upstream update"

Record: Whether changes were stashed (you'll need to unstash later)

Step 3: Determine Tracking Remote and Fetch

First, detect which remote to use:

TRACKING_REMOTE=$(git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>/dev/null | cut -d'/' -f1 || echo "")

Then fetch from the appropriate remote:

if [ -n "$TRACKING_REMOTE" ]; then
    git fetch "$TRACKING_REMOTE" 2>/dev/null || true
else
    git fetch upstream 2>/dev/null || git fetch origin 2>/dev/null || true
fi

Expected: Fetches latest commits from the tracking remote (or falls back to upstream/origin)

Step 4: Check What's New

Run:

git log HEAD..@{u} --oneline

Show user: List of new commits being pulled

Note: @{u} refers to the upstream tracking branch for your current branch

Step 5: Merge Changes

First, try a fast-forward merge (cleanest option):

git merge --ff-only @{u}

If fast-forward succeeds: Skip to Step 7 (no conflicts possible with fast-forward) If fast-forward fails: Your branch has diverged. Try regular merge:

git merge @{u}

If merge succeeds cleanly: Proceed to Step 7 If conflicts occur: Proceed to conflict resolution

Step 6: Handle Merge Conflicts (if any)