# Ship It

> Use when the user wants to commit, push, create a PR, watch CI, fix errors if any, and merge + cleanup when CI passes. Full ship workflow from branch to main.

- **Type:** Skill
- **Install:** `agentstack add skill-chifunghillmanchan-shipwright-ship-it`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ChiFungHillmanChan](https://agentstack.voostack.com/s/chifunghillmanchan)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ChiFungHillmanChan](https://github.com/ChiFungHillmanChan)
- **Source:** https://github.com/ChiFungHillmanChan/shipwright/tree/main/skills/ship-it

## Install

```sh
agentstack add skill-chifunghillmanchan-shipwright-ship-it
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Ship It

Commit, push, create PR, watch CI, auto-fix failures, merge, and return to main.

## Workflow

```dot
digraph ship {
  "Check status" -> "Has changes?";
  "Has changes?" -> "Commit + Push" [label="yes"];
  "Has changes?" -> "PR exists?" [label="no"];
  "Commit + Push" -> "PR exists?";
  "PR exists?" -> "Watch CI" [label="yes"];
  "PR exists?" -> "Create PR" [label="no"];
  "Create PR" -> "Watch CI";
  "Watch CI" -> "CI checks visible?" ;
  "CI checks visible?" -> "Wait + Retry" [label="no (delay)"];
  "Wait + Retry" -> "Watch CI";
  "CI checks visible?" -> "CI passed?" [label="yes"];
  "CI passed?" -> "Merge + Cleanup" [label="yes"];
  "CI passed?" -> "Diagnose + Fix" [label="no"];
  "Diagnose + Fix" -> "Commit + Push";
  "Merge + Cleanup" -> "Done";
}
```

## Steps

### 1. Commit & Push
- If working tree has changes: stage, commit with descriptive message, push
- If clean but not pushed: push
- If already pushed: skip to PR

### 2. Create PR (if none exists)
- Check with `gh pr list --head `
- If no PR: `gh pr create` with summary of all commits since main
- If PR exists: use existing PR number

### 3. Watch CI (CRITICAL — never skip this)

CI checks may take time to appear after push/PR creation. You MUST confirm checks are visible and passing before merging.

**Step 3a: Wait for checks to appear**
- Run `gh pr checks ` to see if checks are listed
- If "no checks reported" is returned, CI has not started yet — this does NOT mean "no errors"
- Wait 15-30 seconds and retry: `gh pr checks `
- Repeat up to 6 times (total ~3 minutes) until checks appear
- If checks never appear after 6 retries, inform the user — do NOT assume it's safe to merge

**Step 3b: Watch checks until completion**
- Once checks are visible, run `gh pr checks  --watch` to wait for all checks to finish
- Only proceed to merge when ALL checks show as passed
- If `--watch` exits with code 0, checks passed
- If `--watch` exits with non-zero, checks failed — go to step 4

**NEVER merge when:**
- `gh pr checks` returns "no checks reported" — checks haven't loaded yet
- Any check is still "pending" or "in_progress"
- Any check has failed

### 4. On CI Failure
- Run `gh pr checks ` to identify which check failed
- Fetch the failed check's logs: `gh run view  --log-failed`
- Diagnose the error (lint, type-check, test failure, build error)
- Fix the issue in code
- Commit the fix, push, and go back to step 3 (watch CI again)
- Repeat until CI passes (max 3 fix attempts, then ask user)

### 5. On CI Pass — Merge & Cleanup
- Only after ALL checks are confirmed green
- Squash merge: `gh pr merge  --squash --delete-branch`
- If branch protection blocks merge, use `--admin` flag
- Checkout main: `git checkout main && git pull`
- Confirm completion

## Important
- Always use `--squash` merge to keep main history clean
- **NEVER merge without confirmed green CI** — "no checks" means "not loaded yet", not "no errors"
- Max 3 auto-fix attempts before asking the user for help
- Never force push or use destructive git commands
- Follow the project's existing commit message conventions

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ChiFungHillmanChan](https://github.com/ChiFungHillmanChan)
- **Source:** [ChiFungHillmanChan/shipwright](https://github.com/ChiFungHillmanChan/shipwright)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-chifunghillmanchan-shipwright-ship-it
- Seller: https://agentstack.voostack.com/s/chifunghillmanchan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.