ship-it

Push the current branch to GitHub and create a pull request via gh.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/arka6fx/pixify --skill ship-it-arka6fx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-it
Source: https://github.com/arka6fx/pixify/tree/main/.agents/skills/ship-it
Command: npx skills add https://github.com/arka6fx/pixify --skill ship-it-arka6fx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pushes the current branch to GitHub and creates a pull request, automating the end-to-end workflow from local work to review.

This capability reduces manual steps and speeds up collaboration by ensuring code changes are ready for review with minimal friction.

Core Features & Use Cases

  • Prerequisite validation: verifies Git, GitHub CLI installation, authentication, and that a remote named origin exists.
  • Branch management: detects the current branch, creates a feature branch from the default when necessary, and coordinates pushing to origin.
  • PR generation: builds a concise PR title and body from recent commits and opens the pull request on the target branch for review.
  • Use cases: ideal for teams that want to accelerate code reviews after local changes without running local quality gates.

Quick Start

Ensure GitHub CLI is installed and authenticated, then invoke the ship-it command to push your current branch and open a pull request.

Frequently Asked Questions about ship-it

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

FAQPage Schema
How do I push a local branch to GitHub and open a pull request automatically?

Automating your pull request workflow requires verifying Git, GitHub CLI authentication, and the remote origin before pushing the current branch. This ensures code changes are ready for review with minimal friction.

Do I need GitHub CLI installed to automate opening a pull request from my local branch?

Yes, GitHub CLI installation and authentication are required prerequisites. The process checks for GitHub CLI authentication alongside Git and the remote origin to successfully push code and generate the pull request.

How does branch management work when automating GitHub pull request creation?

The branch management mechanism detects the current branch, creates a feature branch from the default branch when necessary, and coordinates pushing to origin. This ensures a valid branch exists before PR generation.

Can I generate a pull request title and body from recent local commits?

Yes, pull request generation builds a concise title and body from recent commits. It then opens the pull request on the target branch, ensuring the review context is automatically populated from your local changes.

What happens if my local repository does not have a remote named origin?

Without a remote named origin, the prerequisite validation fails and stops the workflow. The process checks for a default remote origin to guarantee the branch can be pushed and the pull request can be created.