graphite — Claude Code skill: stacked PRs with gt

What graphite does

The skill covers the Graphite CLI (gt) and whitelists the commands the agent may run: gt *, git add, git reset, git diff, git status, git stash, git checkout, git rebase, git branch and gh pr. Inside there is a quick-reference table, the basic stack workflow, navigation (gt up, gt down, gt top, gt bottom, gt ls), amending a branch with gt modify and submitting with gt submit --no-interactive.

A separate section handles branches Graphite does not track. When gt branch info returns the untracked-branch error, the skill gives two routes: track the branch temporarily with gt track -p main, build the stack, then re-parent the first branch onto main and run gt restack; or stash the work and start from main. There is also a recipe for resetting commits back to unstaged changes and advice to reorder branches with gt move rather than gt create --insert.

Before submitting, the skill tells the agent to confirm with gt ls that the first branch sits on main, then run lint, build and tests using the commands from the project's CLAUDE.md. PR descriptions should be written to /tmp/pr-body.md and applied with gh pr edit --body-file instead of a heredoc, because shell escaping breaks markdown. In deep stacks gt restack can touch branches outside your work and hit unrelated conflicts; the skill points to a targeted git rebase <target> for that case.