local-plugins/plugins/gh-stack/skills/restack/SKILL.md
Rebase branches, sync with main/trunk, and resolve merge conflicts using gh-stack. REPLACES git rebase — never use it directly. Triggers: 'restack', 'rebase', 'rebase on main', 'sync with main', 'update stack', 'resolve conflicts', 'branches out of date'.
npx skillsauth add luan/dot-claude gh-stack:restackInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Rebase gh-stack branches onto updated parents and resolve merge conflicts.
| Mode | Command | When |
|------|---------|------|
| Full sync | gh stack sync | Default — fetch, rebase, push, sync PR state |
| Rebase only | gh stack rebase | User says "rebase" / "restack" without push |
| Upstack only | gh stack rebase --upstack | After mid-stack changes |
Sync: gh stack sync 2>&1
If clean: report which branches were rebased. Done.
If conflicts (exit code 3): run gh stack rebase then loop until resolved —
a. Read each conflicted file in full before editing
b. Identify all conflict markers (<<<<<<<, =======, >>>>>>>)
c. Resolve every conflict region in a single edit
d. git add <file> each resolved file
e. gh stack rebase --continue 2>&1
f. If new conflicts appear, repeat from (a)
Push after rebase: gh stack push 2>&1
Report: list branches rebased, conflicts resolved, any issues.
<<<<<<< markers. Resolve all of them in one pass.rg -c '<<<<<<<' <file> before git add.gh stack rebase --abort and report to the user.tools
Tree-sitter indexed code navigator (ct sym CLI). Use INSTEAD OF Read/Grep/Glob/Bash when exploring existing code, understanding how something works, locating a symbol, tracing the call graph up (impact) or down (trace), finding implementations of an interface, scoping a diff to one symbol, or preparing to edit code you have not read yet. Triggers: 'how does X work', 'explain this class/file/symbol', 'walk me through X', 'what does X do', 'where is X defined', 'who calls X', 'what does X call', 'find implementations of', 'what breaks if I change X', 'outline this file', 'map imports', 'show me this symbol', exploring unfamiliar repo, tracing call graph, scoping diff to a symbol, preparing to edit code I haven't read, about to Read a file over ~500 lines to understand it. Do NOT use for: writing new code from scratch, editing prose or config, running tests, or when a stack trace already names the file and line.
development
Fully autonomous development workflow from prompt to commit. Chains spec → develop → review → commit. Triggers: /vibe, 'vibe this', 'autonomous workflow', 'just do it all', 'build this end-to-end', 'full pipeline', 'handle everything'.
development
Comprehensive vault maintenance — cross-references blueprints against codebase state to produce a maintenance plan: archive consumed artifacts, audit docs for staleness, propose new docs for undocumented stable systems. Triggers: 'vault sweep', 'sweep the vault', 'clean up vault', 'vault maintenance', 'what can we archive', 'audit blueprints', 'vault hygiene', 'blueprint cleanup'. Use whenever the user wants a holistic view of vault health rather than archiving a single artifact (that's /archive). Also use when the user asks what's stale, what needs docs, or whether artifacts can be cleaned up.
development
Analyze current diff, classify changes by risk, and produce structured manual test plan. Triggers: 'test plan', 'what should I test', 'manual testing', 'verification steps', 'QA checklist'. Exits early for trivial changes. Do NOT use when: writing automated tests — use /develop with TDD. Do NOT use when: reviewing code quality — use /crit instead.