ship

Push a branch, open a draft PR, and populate its description.

Updated Oct 28, 2025
One-click install
npx skills add https://github.com/SnowboardTechie/dotfiles --skill ship-snowboardtechie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/SnowboardTechie/dotfiles/tree/main/dot-config/opencode/skills/ship
Command: npx skills add https://github.com/SnowboardTechie/dotfiles --skill ship-snowboardtechie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Wrap up worktree work by pushing the current branch, opening a PR, and filling the description, then reporting the PR URL for quick reference.

Core Features & Use Cases

  • Detects the repository forge (GitHub or Forgejo) and routes PR creation accordingly.
  • Pushes the current branch to origin and opens a draft PR.
  • Fills the PR description using a template when available or provides a comprehensive default description.
  • Applies labels to the PR and reports the final URL for team visibility.
  • Follows the Wrapping Up workflow from the worktrunk skill to ensure consistency.

Quick Start

Run /ship to wrap up the current feature work by pushing the branch, opening a draft PR, and filling the description.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate pushing a git worktree branch and opening a pull request?

To automate pushing a git branch and opening a pull request, use a workflow automation tool that pushes the branch to origin, opens a draft PR, and populates the description automatically.

Can I automatically populate pull request descriptions from a template?

Yes, you can automatically populate pull request descriptions from a template. The automation detects repository templates and fills the PR body, or generates a comprehensive default description if none exists.

Does this PR automation work with both GitHub and Forgejo repositories?

Yes, this PR automation works with both GitHub and Forgejo. It detects the repository forge automatically and routes the pull request creation to the appropriate API or CLI tooling for that platform.

What do I need to set up before automating draft PR creation from a worktree?

Before automating draft PR creation, you need a git repository with an active remote, authentication configured for your chosen forge, and access to the pull request creation APIs or CLI tooling for GitHub or Forgejo.

How are labels applied when opening a draft pull request automatically?

Labels are applied automatically when opening a draft pull request. The workflow applies configured labels to the newly created PR and reports the final URL for team visibility and quick reference.