GitButler Stack Workflows

Create, navigate, and reorganize dependent GitButler stacks for PR workflows.

28|1|Updated Aug 30, 2025
One-click install
npx skills add https://github.com/outfitter-dev/agents --skill gitbutler-stack-workflows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GitButler Stack Workflows
Source: https://github.com/outfitter-dev/agents/tree/main/gitbutler/skills/stack-workflows
Command: npx skills add https://github.com/outfitter-dev/agents --skill gitbutler-stack-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing large features with sequential dependencies often results in monolithic pull requests that are difficult to review and merge. This Skill helps break down complex work into smaller, dependent, and easily reviewable chunks.

Core Features & Use Cases

  • Anchor-Based Stacking: Create dependent virtual branches where each branch builds logically on its parent.
  • Post-Hoc Organization: Reorganize independent branches into a structured stack after exploratory coding.
  • PR Preparation: Streamline the process of creating sequential pull requests for stacked branches, ensuring a clear review flow.
  • Use Case: Break down a major refactoring effort into a stack: first, extract utilities; then, update consumers; finally, clean up deprecated code. Each step becomes a small, reviewable PR.

Quick Start

Create a new feature branch 'auth-oauth' that depends on 'auth-core' using GitButler's stacked branch model.

Frequently Asked Questions about GitButler Stack Workflows

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down a large feature into smaller, reviewable pull requests?

Stacked branches organize dependent features into a sequence where each PR builds on the previous one. GitButler's anchor-based stacking lets you create virtual branches that logically depend on parent branches, turning monolithic work into granular, reviewable chunks that merge in order.

What's the difference between virtual branches and stacked branches in GitButler?

Virtual branches are independent branches you create in GitButler's workspace. Stacked branches extend that model by anchoring each branch to a parent, creating a dependency chain. This structure preserves the logical flow of sequential feature work and simplifies code review.

Can I reorganize independent branches into a stack after I've already coded them?

Yes. Post-hoc reanchoring lets you take exploratory branches and restructure them into a dependent stack after the fact. This is useful when you discover a logical sequence in work you've already done and want to prepare it for sequential PR review.

How do I create sequential pull requests from stacked branches using GitHub CLI?

GitButler's PR workflow guidance walks you through opening each stacked branch as a separate pull request in sequence. The GitHub CLI integrates with this process, letting you push and open PRs for each branch in your stack automatically.

What's a practical use case for stacking in refactoring work?

Break a major refactoring into a stack: extract utilities first, then update consumers, then clean up deprecated code. Each step becomes its own small, focused PR that reviewers can approve independently, reducing merge conflicts and review burden.

Do I need version control knowledge to use GitButler's stacking features?

Familiarity with branching and pull requests helps, but GitButler abstracts much of the complexity. The stacking model works within GitButler's virtual branch workspace, so you interact with branches visually rather than through Git commands directly.