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.