ship
Installation
SKILL.md
Ship
Goal
Put a change on clean, reviewed PRs that are ready to merge. The user merges.
The change can be pre-existing local changes in the working tree, a Linear ticket, or a description of what to build.
Steps
- Implement the change, if necessary. If the changes are already in the working tree, go to step 2. If an approach was agreed earlier, implement it as agreed. Work in a fresh worktree off
main. If you are already in one, use it. If not, make one. Implement the full change locally as one change. Do not think about the PRs yet. Make sure that the full change works.- If the working tree has stubs from the
probeskill, they are the agreed architecture. Implement the details on top of them. Do not change their structure. If the implementation forces a change, tell the user.
- If the working tree has stubs from the
- Split the change into a stack of PRs. Do this only after the full change works. First, use the
deslopskill on the working tree, if it is installed. It removes AI-generated code patterns, so that the reviewers see clean code. Each PR does one thing that you can see. If the split is simple and clear, tell the user the split and continue. If the change is complex or you can split it in different ways, wait for the user to approve the split. If you are not sure, wait. Use the stack split guidance below. - Open the PRs. Attach before and after evidence. If you have evidence from the
reproduceskill, attach it, because it shows more. If not, attach screenshots of the visible changes. - Run the review loop. Use only the reviews from Codex and Devin. Sort each finding with the review triage below. Record each ignored finding on the PR. Examine the PRs again at intervals of approximately 10 minutes with a scheduled check-in. Do not wait for the user to ask. Stop the loop when CI is green and the latest findings are only ones that you ignore. Do not push small changes only to get a clean result from the reviewers. When the loop stops, remove the scheduled check-ins.
- Report. When the review loop is complete, give the user the final report.