wf-ship

Create a feature-branch pull request by cherry-picking unpushed commits.

1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/andeart/dotfiles --skill wf-ship
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wf-ship
Source: https://github.com/andeart/dotfiles/tree/main/agents/skills/wf-ship
Command: npx skills add https://github.com/andeart/dotfiles --skill wf-ship

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Package and ship current work into a PR, while cleaning up local state and ensuring safe branch handling.

Core Features & Use Cases

  • Detects current branch and default branch.
  • Creates a dedicated feature branch from upstream and cherry-picks unpushed commits.
  • Pushes, creates a PR with a structured summary, and cleans up local state on completion.
  • Handles both default-branch shipping and feature-branch shipping scenarios, with safety checks for repo and remote configuration.

Quick Start

Ship your current work into a PR and clean up the local state.

Frequently Asked Questions about wf-ship

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

FAQPage Schema
How do I automate pull request creation from unpushed commits?

Yes, it handles default-branch shipping by creating a dedicated feature branch from upstream first, then cherry-picking your unpushed commits before pushing and creating the pull request.

Can I ship work directly from the default branch into a PR?

Yes, it handles default-branch shipping by creating a dedicated feature branch from upstream first, then cherry-picking your unpushed commits before pushing and creating the pull request.

Does the PR packaging workflow clean up local state after creating the pull request?

Yes, the PR packaging workflow cleans up your local state automatically upon completion, removing temporary references after successfully pushing the feature branch and creating the pull request.

What safety checks are performed before creating a feature branch for a pull request?

Before creating a feature branch, the workflow performs safety checks for repository and remote configuration to ensure the upstream default branch is accessible and the local state is safe to modify.

Do I need git and GitHub CLI to automate feature branch PR creation?

Yes, you need git and the GitHub CLI installed, because the workflow relies on git for branch creation and cherry-picking, and uses gh pr create to generate the final pull request.