gitbutler-guide

Guides GitButler virtual and stacked branches, commit manipulation, and pull request automation.

2|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/galligan/agents --skill gitbutler-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitbutler-guide
Source: https://github.com/galligan/agents/tree/main/skills/gitbutler-guide
Command: npx skills add https://github.com/galligan/agents --skill gitbutler-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance and operational commands for using GitButler, a powerful tool for managing complex branching and commit workflows, thereby streamlining version control and collaboration.

Core Features & Use Cases

  • Virtual Branches: Understand and manage multiple branches simultaneously in your workspace without context switching.
  • Stacked Branches: Learn to create and manage dependent branches for sequential development.
  • Commit Organization: Master commands for staging, committing, amending, moving, and squashing commits with precision.
  • Publishing & PRs: Automate the process of pushing branches and creating pull requests.
  • Review Feedback: Efficiently handle review comments across multiple branches using absorb.
  • Use Case: When working on a large feature that needs to be broken down into smaller, reviewable parts, or when managing multiple independent features concurrently, this skill ensures you can navigate and manage your GitButler workflow effectively.

Quick Start

Use the gitbutler-guide skill to learn how to create a new virtual branch named 'feature-x'.

Frequently Asked Questions about gitbutler-guide

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

FAQPage Schema
How do I manage multiple branches simultaneously without context switching in git?

Virtual branches allow you to work on multiple independent features concurrently in a single workspace, eliminating the need for constant git checkout context switching. GitButler facilitates this parallel development by tracking changes per branch automatically.

How do I create and manage stacked branches for sequential feature development?

Stacked branches in GitButler let you create dependent branches for sequential development, where one branch builds upon another. This skill provides the specific CLI commands to establish, organize, and manage these stacked branch hierarchies effectively.

What is the best way to handle review feedback across multiple branches?

Handling review feedback across multiple branches is streamlined using the GitButler `absorb` command. This feature efficiently integrates code review comments and applies the necessary fixes across your active virtual branches in parallel.

How do I automate pushing branches and creating pull requests?

Publishing and pull request automation in GitButler streamlines the process of pushing branches and generating PRs. This skill provides the exact CLI commands to automatically push your virtual branches to the remote repository and initiate pull requests.

Can I stage, move, and squash commits precisely within a GitButler workflow?

Commit organization within GitButler supports precise staging, committing, amending, moving, and squashing of commits. This skill details the specific operational commands needed to manipulate commit history across your virtual branches accurately.

When do I need to use virtual branches for feature decomposition?

Virtual branches are needed when working on a large feature that must be broken down into smaller, reviewable parts, or when managing multiple independent features concurrently. They allow simultaneous branch management without disrupting your workspace.