Branch Recap
Summarize what happened on the current branch so the user can pick up where they left off.
Gather Context
These commands run automatically when the skill loads — output replaces each line below. Use whatever succeeded.
- Current branch: !
git branch --show-current
- Working tree (short): !
git status --short
- Unstaged stat: !
git diff --stat
- Staged stat: !
git diff --cached --stat
- Recent commits: !
git log --oneline -10
- Base detection: !
git rev-parse --verify origin/main 2>/dev/null && echo "BASE=main" || (git rev-parse --verify origin/master 2>/dev/null && echo "BASE=master") || true
- Branch commits: !
git log "origin/$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo main || echo master)..HEAD" --oneline 2>/dev/null || true
- Branch commit messages: !
git log "origin/$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo main || echo master)..HEAD" --format="%h %s%n%b" 2>/dev/null || true
- Branch diff stat: !
git diff "origin/$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo main || echo master)..HEAD" --stat 2>/dev/null || true
- Open PR: !
gh pr view --json number,title,url,state,body,reviews,statusCheckRollup 2>/dev/null || true
If any output was empty, that information is unavailable for this repo — skip the corresponding section in the recap.
Produce the Recap
Print a concise summary using this structure. Omit any section that has no content.
## Branch Recap: <branch-name>
### Goal
<1-2 sentences describing WHY this work exists — the initial task or motivation.
Infer from: branch name (e.g. feat/add-user-avatar → "Add user avatar support"),
PR description body (if exists), first commit message, and the overall shape of changes.
If the PR body contains context, prefer that — it's the most intentional description.>
### What was done
<1-5 bullet points summarizing the commits, grouped by intent — not one bullet per commit.
Derive intent from commit messages, branch name, and the diff.>
### Current state
- Branch: <branch> (<N commits ahead of <base>>)
- PR: #<N> <title> (<state>) — <url> OR No PR yet
- CI: <passing/failing/pending> (from statusCheckRollup, if available)
- Uncommitted changes: <none / N files modified, M staged>
### What might be next
<1-3 bullets. Infer from:
- Uncommitted changes → unfinished work
- No PR yet → create one
- PR is draft → mark ready
- CI failing → fix CI
- PR has review comments → address feedback
- Everything clean and merged → done>
Edge Cases
- On main with no divergent commits: Report "On main — no branch work in progress." Show uncommitted changes if any, otherwise say the working tree is clean.
- Detached HEAD: Report the detached state and show recent commits from
git log -5 --oneline. Skip PR and branch-relative sections.
- No remote configured: Skip PR and base-branch comparison. Use
git log -10 --oneline and uncommitted changes only.
- Brand new repo (no commits): Report "New repository — no commits yet." Show staged/untracked files if any.
- gh CLI unavailable: Skip PR section entirely. Do not error.
Rules
- This is read-only — never modify files, branches, or PRs.
- Keep the output compact. The user wants a glance, not a report.
- Do not print raw diffs or full file contents. Summarize.
- If everything is clean (on main, no changes, no open PR), say so in one line and stop.
1---2name: branch-recap3description: Use when recapping the current branch or picking up unfinished branch work: catch me up, what did I do, where was I.4---56# Branch Recap78Summarize what happened on the current branch so the user can pick up where they left off.910## Gather Context1112These commands run automatically when the skill loads — output replaces each line below. Use whatever succeeded.1314- Current branch: !`git branch --show-current`15- Working tree (short): !`git status --short`16- Unstaged stat: !`git diff --stat`17- Staged stat: !`git diff --cached --stat`18- Recent commits: !`git log --oneline -10`19- Base detection: !`git rev-parse --verify origin/main 2>/dev/null && echo "BASE=main" || (git rev-parse --verify origin/master 2>/dev/null && echo "BASE=master") || true`20- Branch commits: !`git log "origin/$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo main || echo master)..HEAD" --oneline 2>/dev/null || true`21- Branch commit messages: !`git log "origin/$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo main || echo master)..HEAD" --format="%h %s%n%b" 2>/dev/null || true`22- Branch diff stat: !`git diff "origin/$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo main || echo master)..HEAD" --stat 2>/dev/null || true`23- Open PR: !`gh pr view --json number,title,url,state,body,reviews,statusCheckRollup 2>/dev/null || true`2425If any output was empty, that information is unavailable for this repo — skip the corresponding section in the recap.2627## Produce the Recap2829Print a concise summary using this structure. Omit any section that has no content.3031```text32## Branch Recap: <branch-name>3334### Goal35<1-2 sentences describing WHY this work exists — the initial task or motivation.36 Infer from: branch name (e.g. feat/add-user-avatar → "Add user avatar support"),37 PR description body (if exists), first commit message, and the overall shape of changes.38 If the PR body contains context, prefer that — it's the most intentional description.>3940### What was done41<1-5 bullet points summarizing the commits, grouped by intent — not one bullet per commit.42 Derive intent from commit messages, branch name, and the diff.>4344### Current state45- Branch: <branch> (<N commits ahead of <base>>)46- PR: #<N> <title> (<state>) — <url> OR No PR yet47- CI: <passing/failing/pending> (from statusCheckRollup, if available)48- Uncommitted changes: <none / N files modified, M staged>4950### What might be next51<1-3 bullets. Infer from:52 - Uncommitted changes → unfinished work53 - No PR yet → create one54 - PR is draft → mark ready55 - CI failing → fix CI56 - PR has review comments → address feedback57 - Everything clean and merged → done>58```5960## Edge Cases6162- **On main with no divergent commits:** Report "On main — no branch work in progress." Show uncommitted changes if any, otherwise say the working tree is clean.63- **Detached HEAD:** Report the detached state and show recent commits from `git log -5 --oneline`. Skip PR and branch-relative sections.64- **No remote configured:** Skip PR and base-branch comparison. Use `git log -10 --oneline` and uncommitted changes only.65- **Brand new repo (no commits):** Report "New repository — no commits yet." Show staged/untracked files if any.66- **gh CLI unavailable:** Skip PR section entirely. Do not error.6768## Rules6970- This is **read-only** — never modify files, branches, or PRs.71- Keep the output compact. The user wants a glance, not a report.72- Do not print raw diffs or full file contents. Summarize.73- If everything is clean (on main, no changes, no open PR), say so in one line and stop.
neumie