skills.rest
NalinDalal
NalinDalalCOMMUNITY
Explore all skills by this author →
Website𝕏@nalin82929GitHub

ship

Automates the git ship workflow from branch detection through PR creation.

1|Updated Aug 17, 2026
Search Tags:#git#testing#code review#pull request#deployment#github#gitlab
One-click install
npx skills add https://github.com/NalinDalal/skillset --skill ship-nalindalal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/NalinDalal/skillset/tree/main/skills/workflow/ship
Command: npx skills add https://github.com/NalinDalal/skillset --skill ship-nalindalal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipping code involves a repetitive sequence of manual steps: checking the branch, running tests, reviewing the diff, committing, pushing, and opening a pull request. This Skill runs that entire sequence as one guided workflow so nothing gets skipped. ## Core Features & Use Cases - Platform and base branch detection: Identifies GitHub or GitLab remotes and resolves the correct base branch via gh, glab, or git fallbacks. - Pre-flight checks and test execution: Blocks shipping from the base branch, includes uncommitted changes, and auto-detects test suites for npm, pytest, Go, and Cargo projects. - Diff review, commit, push, and PR creation: Scans the diff for bugs, secrets, and stray files, commits with conventional commit messages, pushes, and opens a PR with a structured body. - Use Case: You finish a feature on a branch and say "ship it". The Skill runs your tests, reviews the diff, commits, pushes, and returns the PR URL. ## Quick Start Ask the agent to ship the current branch and create a pull request against the base branch.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I create a pull request from the command line?▼

Use gh pr create with a base branch, title, and body after pushing your branch with git push. This Skill automates that sequence, including base branch detection and a structured PR body covering what changed and how to test it.

How to run tests before pushing code automatically?▼

Detect the project type from marker files like package.json, pyproject.toml, go.mod, or Cargo.toml, then run the matching test command. This Skill runs the detected suite and asks whether to proceed or fix first when tests fail.

Does this workflow support GitLab merge requests?▼

Yes, it detects GitLab remotes and uses glab mr view and glab repo view to resolve the base branch. GitHub uses the gh CLI, with git symbolic-ref as a fallback for either platform.

What happens if I try to ship from the main branch?▼

The workflow aborts during pre-flight checks when the current branch is the base branch. It instructs you to ship from a feature branch instead, preventing accidental direct pushes to main or master.

What does the diff review check before committing?▼

The review checks for obvious bugs like missing null checks and error handling, hardcoded secrets or credentials, files that should not be committed such as .env or node_modules, and missing tests for new functionality.

Related Skills

Explore More Software Engineering Skills→
ceratops-codeceratops-code

ceratops-codex-skill-stage-release

Merge task-worktree branches into a local release branch and validate the staged batch.

Official
Advanced
dimakisdimakis

land-pr

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

Community
Intermediate
devopstalesdevopstales

springboot-verification

Automate Spring Boot verification with build, static analysis, tests, and security scans.

Community
Advanced
KrosebrookKrosebrook

Git Advanced Workflow Expert

Automates Git workflows for trunk-based development and monorepo management.

Community
Intermediate