ship

Automates git branch creation, Conventional Commits, push, and pull request generation.

Updated May 22, 2026
One-click install
npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill ship-gleisonoliveira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/GleisonOliveira/dockerpilot-mcp/tree/main/.claude/skills/ship
Command: npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill ship-gleisonoliveira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually running the full git ship workflow—creating a branch, staging changes, writing a proper commit message, pushing, and opening a pull request—is repetitive and error-prone, especially remembering to never commit to main and to follow Conventional Commits format. ## Core Features & Use Cases - Safe Branching: Automatically detects if you are on main or master and creates a properly named feature branch (e.g., feat/add-export) before committing. - Conventional Commits: Analyzes the staged diff and generates an English commit message in Conventional Commits format, with user confirmation before committing. - Automated PR Creation: Pushes the branch and opens a pull request via the GitHub CLI, filling in the project's PR template sections based on the diff. - Use Case: After finishing a bug fix, simply say "ship it" and the skill creates a fix branch, commits with a proper message, pushes, and opens a PR with a filled template. ## Quick Start Ask the assistant to ship my current changes by committing them on a new branch and opening a pull request.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I commit and open a pull request in one step?▼

Invoke the ship workflow by saying "ship", "commit", or "abrir PR". It creates a branch if needed, stages all changes, generates a Conventional Commits message, pushes, and opens a PR using the GitHub CLI.

How do I write a Conventional Commits message automatically?▼

The skill analyzes the output of git diff --cached and generates a message in the format type(scope): summary, keeping the subject under 72 characters. It shows you the message for confirmation before committing.

Can I accidentally commit directly to main with this workflow?▼

No. The skill checks the current branch first and always creates a new branch if you are on main or master. It also never uses --force or --no-verify flags.

What happens if the GitHub CLI is not installed?▼

If the gh CLI is not available, the skill warns you and stops after pushing the branch. Your commit and push still complete, but no pull request is created.

Does the pull request use my project's PR template?▼

Yes. The skill reads .github/pull_request_template.md if it exists and fills each section based on the diff. If no template is found, it uses a plain summary as the PR body.