gh-stack

Create, modify, and synchronize stacks of GitHub pull requests.

Updated Jun 9, 2020
One-click install
npx skills add https://github.com/bgschiller/dotfiles --skill gh-stack-bgschiller
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-stack
Source: https://github.com/bgschiller/dotfiles/tree/main/skills/gh-stack
Command: npx skills add https://github.com/bgschiller/dotfiles --skill gh-stack-bgschiller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires github-cli, gh-stack-extension, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the complexity of managing stacks of GitHub pull requests, simplifying the process of creating, navigating, and synchronizing stacks of dependent PRs.

Core Features & Use Cases

  • Stack Management: Create, add, and manage stacks of PRs with ease.
  • Navigation: Navigate through stacks using intuitive commands.
  • PR Synchronization: Keep PRs in sync with their base branches.
  • Use Case: For a complex feature requiring multiple dependent PRs, use this Skill to maintain a clean and organized stack of PRs.

Quick Start

Use the gh stack init -p feat my-feature command to create a new stack for your feature.

Frequently Asked Questions about gh-stack

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

FAQPage Schema
How do I manage stacked PRs on GitHub for a complex feature?

Manage stacked PRs on GitHub by using commands to create, modify, and synchronize stacks of dependent pull requests. This keeps complex feature development workflows organized across multiple PRs.

What is the best way to synchronize a stack of dependent pull requests?

Synchronize a stack of dependent pull requests by keeping the PRs in sync with their base branches. This ensures that structural changes in lower-level PRs automatically reflect in the dependent PRs above them.

Do I need the GitHub CLI to create a stack of pull requests?

Yes, you need the GitHub CLI v2.0+ and the gh-stack extension to create a stack of pull requests. These dependencies provide the necessary environment for stack management commands to function.

How do I initialize a new stack of pull requests for my feature branch?

Initialize a new stack of pull requests for your feature branch by running the `gh stack init -p feat my-feature` command. This sets up the foundational structure for adding and navigating dependent PRs.

Can I navigate through a stack of dependent PRs without losing track of the base branch?

Yes, you can navigate through a stack of dependent PRs using intuitive commands designed to maintain context. This allows you to move through the stack while keeping each PR synchronized with its respective base branch.