Agent skill

update-graphite-stack

Update Graphite PR stacks by addressing review comments and syncing PRs. Use when user says "update my graphite stack", "address the review comments on my stack", "sync my PR stack after these changes", "submit my entire stack to Graphite", or "I need to update all the PRs in my stack".

Stars 30
Forks 9

Install this agent skill to your Project

npx add-skill https://github.com/Uniswap/ai-toolkit/tree/next/packages/plugins/development-pr-workflow/skills/update-graphite-stack

SKILL.md

Graphite Stack Updater

Automate Graphite PR stack updates by resolving comments and syncing PRs.

Note: This skill requires Graphite CLI (gt) as PR stacking is a Graphite-specific concept. For standard Git workflows, use the pr-issue-resolver skill to address PR comments on individual PRs.

When to Activate

  • User has a Graphite stack with comments
  • Multiple PRs need updating
  • Stack sync needed after changes
  • Review comments to address
  • User mentions "gt stack" or "update stack"

Prerequisites

  • Graphite CLI installed: npm install -g @withgraphite/graphite-cli@latest
  • Repository initialized with Graphite: gt repo init
  • Existing Graphite stack with PRs to update

Why Graphite-only? This skill manages PR stacks, which is a Graphite-specific workflow. For standard Git workflows, use pr-issue-resolver to address comments on individual PRs.

What It Does

  1. Analyze Stack: Check structure with gt stack
  2. Find Comments: Identify PRs with unresolved feedback
  3. Address Feedback: Help resolve comments
  4. Update Stack: Use Graphite commands to sync
  5. Verify: Ensure all upstack PRs remain in sync

Execution Flow

For each PR with comments (bottom to top):

  1. Review the feedback
  2. Make necessary changes
  3. Run gt modify --no-verify to amend
  4. Execute gt submit --stack --update-only to sync upstack
  5. Continue until all PRs updated

Key Graphite Commands Used

bash
gt stack           # View current stack
gt modify          # Amend current commit
gt submit --stack  # Update all PRs in stack

Options

  • Process entire stack or specific PR range
  • Filter by comment type (style, logic, performance)
  • Dry-run mode to preview changes
  • Auto-commit vs manual review mode

Output

Progress summary with:

  • Number of PRs updated
  • Comments resolved per PR
  • Remaining unresolved items
  • Stack synchronization status

Optional Follow-up

After updates, can invoke refactorer-agent to verify changes maintain quality.

Examples

"Update my graphite stack"
"Address the review comments on my stack"
"Sync the stack starting from PR #123"

Didn't find tool you were looking for?

Be as detailed as possible for better results