devops-skills

/ship-it

A Claude Code skill and GitHub Action that gets a developer's code into production with zero DevOps knowledge required. Run /ship-it and it handles everything -- branching, committing, pushing, workflow generation, PR creation, reviewer assignment, and a go-live checklist.

What It Does

Command	What Happens
/ship-it	Ships your code to production. Creates a branch, pushes, generates a CI/CD workflow, creates a PR with reviewers and a go-live checklist.
/ship-it save	Saves your work in progress. Commits, pushes, creates a draft PR. No review triggered.

The developer sees two sentences of output. Everything else happens silently.

How It Works

1. Silent preflight -- Checks git repo, GitHub auth, current branch, .ship-it.yml config, app-context.json (from /make-it), open PRs, uncommitted changes, and project type. All in one command.
2. Intent classification -- Three yes/no questions determine if this is an experiment, shareable, or production-ready.
3. Branch + commit + push -- Creates a branch if on main, stages changes, commits, pushes.
4. Workflow generation -- If no CI/CD workflow exists, generates one based on available infrastructure config.
5. PR creation -- Creates a labeled PR with app details, reviewer assignment, and a smart go-live checklist.
6. Done -- Reports back with the PR URL.

Three Modes

Mode	Trigger	Behavior
Ship	/ship-it (default)	Full production path -- branch, push, workflow, PR with reviewers
Save	/ship-it save	Work-in-progress -- push and create draft PR
Re-run	/ship-it when PR already exists	Updates existing PR with new commits, or reports PR status

Intent Classification

Three yes/no questions classify every deployment:

Intent	Label	Deploy Target	Meaning
Experiment	intent:experiment	None	"Just trying something out"
Shareable	intent:shareable	Dev only	"Others should see this"
Prod-ready	intent:prod-ready	Dev + Prod	"This is ready for real users"

Works With /make-it

When used on a project built by /make-it, /ship-it automatically reads app-context.json and .make-it-state.md to:

• Skip app-type and stack questions (already known)
• Auto-generate the app section of .ship-it.yml
• Create a smart prerequisites checklist (pre-checking items make-it already configured)
• Populate the PR body with app details (stack, services, auth, database)

/ship-it also works standalone on any GitHub project -- it just asks a few extra questions.

See docs/handoff.md for the full merge logic and docs/walkthrough.md for the end-to-end user experience.

Prerequisites

Tool	How to Install
Git	brew install git
GitHub CLI	brew install gh then gh auth login
Claude Code	npm install -g @anthropic-ai/claude-code

Installation

As a Claude Code Skill

Option A: One-Line Install (recommended)

No clone needed. Just run:

curl -fsSL https://raw.githubusercontent.com/sealmindset/ship-it/main/install.sh | bash

This downloads the latest release and installs the skill into ~/.claude/.

Option B: Clone and Install

git clone https://github.com/sealmindset/ship-it.git
cd ship-it
bash install.sh

Option C: Manual Install

git clone https://github.com/sealmindset/ship-it.git ~/.claude/ship-it-skill
mkdir -p ~/.claude/commands
cp ~/.claude/ship-it-skill/skills/ship-it/SKILL.md ~/.claude/commands/ship-it.md

Verify Installation

claude
# Then type /ship-it

Updating

Update from the terminal:

curl -fsSL https://raw.githubusercontent.com/sealmindset/ship-it/main/install.sh | bash

Or if you have the repo cloned:

cd ~/path/to/ship-it
git pull
bash install.sh

As a GitHub Action

Add the action to your workflow:

name: ship-it pipeline
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  ship-it:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: sealmindset/ship-it@main
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}

Or reference a shared reusable workflow:

name: ship-it pipeline
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  ship-it:
    uses: {ORG}/{REPO}/.github/workflows/ship-it-pipeline.yml@main
    with:
      environment-dev: dev
      environment-prod: prd
    secrets: inherit

Configuration

.ship-it.yml

Drop this file in the root of any repo. It has three sections with different owners: