stave-worktree-pr-flow

Ship the current working state as a GitHub pull request using a worktree.

3|1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/sendbird-playground/stave --skill stave-worktree-pr-flow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stave-worktree-pr-flow
Source: https://github.com/sendbird-playground/stave/tree/main/skills/stave-worktree-pr-flow
Command: npx skills add https://github.com/sendbird-playground/stave --skill stave-worktree-pr-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shipping the full current working state as a GitHub pull request, reusing an existing workspace worktree when already inside a linked worktree.

Core Features & Use Cases

  • Reuse existing worktree: If you're already in a workspace-linked worktree, it reuses that same worktree to avoid unnecessary duplication.
  • Safe state migration: If not in a linked worktree, it moves the dirty state into a dedicated temporary worktree to preserve your original checkout.
  • Conventional commits & PR creation: Commits with Conventional Commit messages, pushes with proper safeguards, and opens a PR with a concise description.
  • Guardrails & validation: Checks for appropriate base branches, writable remotes, and PR launching prerequisites, surfacing conflicts or blockers when needed.

Quick Start

Ask Stave to ship all current changes as a PR, reusing the current worktree if applicable.

Frequently Asked Questions about stave-worktree-pr-flow

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

FAQPage Schema
How do I ship my current git worktree changes as a pull request in one pass?▼

To ship worktree changes to a pull request, the Skill commits your dirty working state with Conventional Commits, pushes to a writable GitHub remote, and opens a PR while preserving your original checkout in a single pass.

What happens to my original git checkout when moving dirty state to a temporary worktree?▼

When moving dirty state to a temporary worktree, your original checkout is preserved safely. If you are already inside a linked workspace worktree, it reuses that existing worktree instead of creating a duplicate to commit and push your changes.

Do I need Conventional Commits syntax to automate pull request creation from a worktree?▼

Yes, Conventional Commits syntax is enforced for commit messages during pull request creation. The automation validates your environment, ensures a valid base branch, and surfaces conflicts or blockers as guardrails before pushing to the GitHub remote.

How does worktree PR automation handle git conflicts or invalid base branches?▼

Worktree PR automation handles git conflicts and invalid base branches by enforcing strict guardrails. It validates the environment, checks for a writable GitHub remote, and surfaces any blockers or conflicts directly to prevent bad pushes.

Can I reuse an existing workspace worktree instead of creating a temporary one for a pull request?▼

You can reuse an existing workspace worktree if you are already inside a linked worktree. The automation detects the linked state and commits directly there, avoiding unnecessary duplication before pushing and opening the pull request.