| name | catchup |
| description | This skill should be used when the user asks to "catch me up", "what's on this branch", "summarize this branch", "what changed since main", or wants a structured summary of commits, changed files, and current state of the working branch compared to main/master. |
Catchup: Branch Summary
Quickly understand what has changed in the current working branch compared to main/master.
Behavior
- Detect base branch (main or master)
- Detect platform (check for
.gitlab-ci.yml → glab, otherwise → gh)
- Get commit log since divergence from base branch
- Get all changed files with
git diff <base>...HEAD --stat
- Read changed files for context
Output Format
Commit Summary
- List commits with their semver prefixes and short descriptions
Changes by Area
Group changed files into categories:
- Migrations: new/modified database migrations
- Config: settings files, CI config, dependency changes
- Source: application code changes
- Tests: new/modified tests
Key Changes
- Highlight breaking changes or API modifications
- Note new dependencies added (check pyproject.toml, package.json, Cargo.toml diffs)
- Flag any renamed/moved files
PR/MR Context
- If on a branch with an open PR/MR, show its title and status
- Use
gh pr view or glab mr view depending on detected platform
Current State
- Any uncommitted changes
- Potential issues or blockers
