ShipfoxHQ/shipfox / .agents/skills/ship
ship
VerifiedShip a Linear issue end to end: implement it, open the pull request, then loop on merge conflicts, CI failures, and review comments until the pull request is green and every review thread is handled, and keep it rebased on main until it merges. Trigger on /ship, ship ENG-123, or take an issue all the way to a reviewed pull request.
Ship an issue
Take one Linear issue from implementation to a green, reviewed pull request.
Input
/ship <issue> [--max-iterations N] [--watch-minutes M]
<issue>is a Linear issue key, ID, or URL. If it is missing, ask for it and stop.--max-iterationscaps the review loop. The default is 10.--watch-minutessets how often the watch phase checks for conflicts and new comments. The default is 10.
Process
- Invoke the
implement-issueskill with the issue. Follow it completely, including its pause when requirements conflict. - Invoke the
prskill. It commits pending changes through thecommitskill and opens the pull request. - Record the pull request number with
gh pr view --json number,url. - Run the loop below until a stop condition holds.
- Print the summary whenever the loop stops. If it stopped with CI green and no open comment, enter the watch phase.
Loop
Each iteration runs these steps in order.
Sync with main
gh pr view <number> --json mergeable --jq .mergeable
GitHub reports UNKNOWN while it computes the result. Retry after a few
seconds. If the result is CONFLICTING, rebase on main:
- Run
git fetch origin mainandgit rebase origin/main. - Resolve each conflict so both the branch change and the main change survive.
Regenerate generated files, such as
pnpm-lock.yamland migration snapshots, instead of merging them by hand. - Run the validation for the affected packages, as the
commitskill selects it. - Push with
git push --force-with-lease.
If a conflict needs a decision about the intent of the main change, abort the
rebase with git rebase --abort and ask the user.
Wait for CI
gh pr checks <number> --watch --fail-fast --interval 30
--fail-fast returns on the first failure so the fix starts while other checks
still run.
CI can outlast a shell command timeout. Run the command in the background, or run it again until it exits. Right after a push, checks may not be registered yet. If the command reports no checks, wait a minute and retry.
If every check passes, continue to the review step. If a check fails, invoke
the fix-ci skill with the pull request number, then start the next iteration.
Address review comments
Run this step only when CI is green. Invoke the address-pr-comments skill
with the pull request number. If it pushed commits, start the next iteration so
CI runs again.
Stop conditions
Stop the loop when the first of these holds:
- CI is green and
address-pr-commentsfound no open comment. - The loop reached
--max-iterations. - The same check fails twice for the same reason after your fix.
- A rebase conflict or a review comment needs a decision from the user.
Do not merge the pull request or mark the Linear issue done.
Watch phase
Every --watch-minutes minutes, check the pull request:
gh pr view <number> --json state,mergeable,reviews,comments
- If
stateisMERGEDorCLOSED, stop and print the final summary. - If
mergeableisCONFLICTING, or a review, comment, or unresolved review thread appeared since the last pass, run the loop again with a fresh iteration count. Review bots often post after CI turns green.
Run each wait in the background if the shell has a command timeout.
Summary
Print:
- The pull request URL and the stop reason.
- The iterations used out of the maximum.
- The final state of each check, and any rerun flaky check.
- The commits pushed during the loop, and each rebase on main.
- Comments fixed, declined, deferred, and still open, with links. Include any Linear issues created.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |