Skip to content

ShipfoxHQ/shipfox / .agents/skills/ship

Ship 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-iterations caps the review loop. The default is 10.
  • --watch-minutes sets how often the watch phase checks for conflicts and new comments. The default is 10.

Process

  1. Invoke the implement-issue skill with the issue. Follow it completely, including its pause when requirements conflict.
  2. Invoke the pr skill. It commits pending changes through the commit skill and opens the pull request.
  3. Record the pull request number with gh pr view --json number,url.
  4. Run the loop below until a stop condition holds.
  5. 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:

  1. Run git fetch origin main and git rebase origin/main.
  2. Resolve each conflict so both the branch change and the main change survive. Regenerate generated files, such as pnpm-lock.yaml and migration snapshots, instead of merging them by hand.
  3. Run the validation for the affected packages, as the commit skill selects it.
  4. 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-comments found 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 state is MERGED or CLOSED, stop and print the final summary.
  • If mergeable is CONFLICTING, 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.
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 108kUpdated Claude CodeCodexVerifiedInstall
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: 108kUpdated Claude CodeCodexVerifiedInstall