ship-it

Commit changes, create and merge a pull request, and close the linked GitHub issue.

207|30|Updated May 16, 2026
One-click install
npx skills add https://github.com/smallnest/goal-workflow --skill ship-it-smallnest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship-it
Source: https://github.com/smallnest/goal-workflow/tree/main/skills/ship-it
Command: npx skills add https://github.com/smallnest/goal-workflow --skill ship-it-smallnest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the repetitive final steps of delivering completed work, so you can turn a finished issue into a committed, reviewed, merged, and closed change without manual coordination.

Core Features & Use Cases

  • Commit and Push: Stages only the files related to the current issue, creates a commit that references the issue number, and pushes the branch to the remote repository.
  • Pull Request Automation: Opens a GitHub pull request with a concise title, a clear summary, and closing keywords so the issue can be linked and auto-closed.
  • Merge and Closure Workflow: Checks PR status, merges with the chosen strategy, adds a post-merge implementation summary comment, and closes the issue when auto-close does not happen.
  • Use Case: A developer finishes implementing a GitHub issue and needs a reliable, repeatable workflow to ship the code and leave a traceable audit trail.

Quick Start

Ask the ship-it skill to commit the completed changes, create and merge the pull request, and close the linked GitHub issue.

Frequently Asked Questions about ship-it

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

FAQPage Schema
How do I automate a GitHub pull request and merge workflow for a finished issue?▼

Automating a GitHub pull request and merge workflow involves staging issue-related files, committing with issue references, pushing the branch, opening a PR with closing keywords, and merging after status checks. This creates a traceable audit trail for shipped code.

How do I close a linked GitHub issue automatically after merging a pull request?▼

To close a linked GitHub issue automatically after merging, include closing keywords in the pull request description. If GitHub's auto-close mechanism does not trigger, a fallback manual closure step ensures the issue is properly bookkept and marked complete.

What is the best way to commit and push only files related to a specific GitHub issue?▼

The best way to commit and push only files related to a specific GitHub issue is to stage those specific changes selectively, create a commit message that references the issue number, and push the branch to the remote repository to prepare for pull request automation.

Do I need git and GitHub CLI installed to automate my branch management and merge workflow?▼

Yes, you need git and GitHub CLI installed to automate branch management, PR metadata creation, merge verification, and post-merge issue bookkeeping. These tools handle the required repository operations and API interactions for end-to-end shipping scenarios.

Why does my GitHub issue stay open after the pull request is merged?▼

A GitHub issue stays open after a pull request is merged when auto-close does not occur, often due to missing or incorrect closing keywords in the PR description. A fallback manual closure step is required to add an implementation summary comment and close the issue.

Can I verify PR status and add a post-merge implementation summary comment automatically?▼

Yes, you can verify PR status and add a post-merge implementation summary comment automatically by checking the pull request state, applying the chosen merge strategy, and generating a traceable audit trail comment on the closed issue.