skills.rest
bearded-giant
bearded-giantCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

ship-it

Automates the commit, push, MR description, and merge request creation chain for Git branches.

Updated Jan 15, 2026
Search Tags:#automation#git#commit#github#push#gitlab#merge request
One-click install
npx skills add https://github.com/bearded-giant/claude-code-config --skill ship-it-bearded-giant
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship-it
Source: https://github.com/bearded-giant/claude-code-config/tree/main/skills/ship-it
Command: npx skills add https://github.com/bearded-giant/claude-code-config --skill ship-it-bearded-giant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipping a finished feature branch requires a repetitive multi-step chain — committing changes, pushing, writing a merge request description, and opening the MR — where steps get skipped or stalled when done manually or loosely instructed. ## Core Features & Use Cases - End-to-end ship chain: Runs commit (Conventional Commits format), push, MR description generation, and MR creation in order with no intermediate confirmation prompts. - Remote-keyed MR formats: Defaults to a concise kai-section format for GitLab remotes and a personal bullet format for GitHub, with brief and full overrides. - Grill gate for risky diffs: Large or data-touching diffs (300+ lines, 10+ files, migrations) require a prior grill review rating before shipping. - Use Case: After finishing work on a feature branch, say "ship it" and the branch is committed, pushed, described, and opened as a GitLab MR or GitHub PR, returning the description and MR URL. ## Quick Start Say "ship it" on a finished feature branch to commit, push, and open the merge request automatically.

Frequently Asked Questions about ship-it

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

FAQPage Schema
How do I commit, push, and open a merge request in one step?▼

Invoke the ship chain by saying "ship it" on a feature branch. It commits pending changes using Conventional Commits, pushes with upstream tracking, writes the MR description, and opens the MR via GitLab or GitHub tooling, returning the description and URL.

How do I choose between bullet and kai MR description formats?▼

Format is selected automatically by remote host: GitLab defaults to the concise kai section format, GitHub to personal bullets. Override with "brief" or "--brief" for bullets, or "full"/"--full" for the verbose org kai template.

Can I ship a branch directly from main or master?▼

No. The chain stops immediately if the current branch is main, master, or stage and instructs you to switch to a feature branch first. This prevents accidental direct commits to protected base branches.

What happens when a git push is rejected during the ship chain?▼

The chain stops immediately and reports the exact error and current branch state. It never force-pushes, amends commits, or takes destructive recovery actions without explicit user instruction.

Why does the ship chain ask about running a grill review first?▼

A grill gate triggers when the diff has 300+ changed lines, 10+ files, or touches migrations and data-emitting scripts. It checks for a prior grill rating and asks once whether to run the review before shipping; small diffs skip this entirely.

Related Skills

Explore More Software Engineering Skills→
AradotsoAradotso
4

stage-cli-code-review

Organize local git diffs into logical chapters for code review.

Official
Intermediate
dimakisdimakis

land-pr

Shepherd GitHub pull requests through CI checks, reviews, and squash merges.

Community
Intermediate
jokerman89jokerman89

plan-eng-review

Reviews implementation plans for architecture, code quality, test coverage, and performance before shipping.

Community
Advanced
soulianesouliane
1

ship

Automate commit, push, and pull request creation in git-based workflows.

Community
Advanced