flow-ship
Skill1 starsChanged 47 days agoMITView on GitHub
Delivery through the requested Git or review stage: commit, push, pull or merge request, ready or merge. Use when asked to push, commit and push, open or update a PR or MR, or merge. Routes to `flow-commit`, `flow-pr-fix`, `flow-git-fix` or `flow-release`.
In this repository38 other files it gives its agents.
- AGENTS.mdAGENTS.md
- llms.txtllms.txt
- flow-a11ySkill
- flow-adversarial-reviewSkill
- flow-animateSkill
- flow-apiSkill
- flow-benchmarkSkill
- flow-brainstormSkill
- flow-commitSkill
- flow-data-migrateSkill
- flow-depsSkill
- flow-designSkill
- flow-diagnoseSkill
- flow-docsSkill
- flow-git-fixSkill
- flow-handoffSkill
- flow-migrateSkill
- flow-observeSkill
- flow-onboardSkill
- flow-orchestrateSkill
- flow-planSkill
- flow-pr-fixSkill
- flow-prototypeSkill
- flow-prune-agent-setupSkill
- flow-redesignSkill
- flow-refactorSkill
- flow-releaseSkill
- flow-repo-briefSkill
- flow-reviewSkill
- flow-simplifySkill
- flow-specializeSkill
- flow-stylesSkill
- flow-testSkill
- flow-triageSkill
- flow-uiSkill
- flow-verifySkill
- flow-workSkill
- flow-write-skillSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 3 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 15
Read current authorization, repository delivery rules, branch/remotes, status and existing change request metadata.
- Very specific: line 24
Run the pre-launch checklist: required format, lint, types, tests, build, generated docs and relevant runtime checks.
- Distinctive: line 26
Run each check fresh and read its output before reporting it.
- Very specific: line 32
Use atomic commits under the conventional-commit policy of flow-commit.
- Distinctive: line 33
After a failed plain commit, fix and create a new commit.
- Very specific: line 53
Verify the remote SHA, change request URL, draft/ready/merged state and check summary.
- Very specific: line 70
Use flow-release for requested versioned publication, flow-pr-fix for later review feedback or flow-git-fix for a demonstrated Git problem.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Ship
Complete the delivery action the user requested. Push, draft change request (pull or merge request), ready, merge, deploy and publish are distinct outcomes; one never authorizes another.
Phase 1: Establish the terminal action
Read current authorization, repository delivery rules, branch/remotes, status and existing change request metadata. Resolve base, head and target remote from evidence; reuse an existing change request. Do not re-prompt for an authorized action, and never treat a skill handoff as permission for an unrequested merge, deployment, reviewer request or message.
Phase 2: Verify the artifact
- Inspect committed, staged, unstaged and relevant untracked changes separately; preserve unrelated user work.
- Run the pre-launch checklist: required format, lint, types, tests, build, generated docs and
relevant runtime checks. Use
flow-reviewwhere the task or repository requires review. - Run each check fresh and read its output before reporting it; record the verified revision. If hooks or CI fixes change behavior, repeat affected checks and review. A previous green revision does not verify the current one; keep unrun checks and missing access explicit.
Phase 3: Commit and push when requested
- Use atomic commits under the conventional-commit policy of
flow-commit. Never bypass hooks. - After a failed plain commit, fix and create a new commit; never amend the unrelated previous commit. Honor an explicitly requested amend only after checking HEAD.
- Push fast-forward to the identified remote/branch. Conflicts or rewritten history go to
flow-git-fix; no routine force-push. Verify the remote head. Do not let a CLI silently pick a fork or push target.
Phase 4: Create or update the requested change request
- A requested draft stops at draft. For ready, follow the repository workflow; draft-first helps when checks must run before readiness, but is not a universal gate.
- Body: problem, change, resulting behavior, validation, meaningful limitations or rollback considerations. Pass it via a structured field or body file with real newlines. No reviewer pings or comments unless requested.
- Inspect checks on the current head and distinguish passed, failed, pending, skipped and absent. Some pipelines run only once a change leaves draft; others are disabled. Do not deadlock on a check that cannot start in draft or call absent CI passing. Use bounded waits and report outstanding required checks.
Phase 5: Confirm the result
Verify the remote SHA, change request URL, draft/ready/merged state and check summary. For an explicitly requested merge, deployment or publication, complete its preparation and required gates first. Otherwise stop at the requested stage with a usable link.
Anti-patterns
- Turning "push this" into a ready change request, reviewer ping, merge and deployment.
- Claiming review passed after adding unreviewed behavioral fixes.
- Treating missing CI as green or waiting forever on a disabled workflow.
- Editing or discarding unrelated staged work for convenience.
Done when
- The authorized stage is reached and confirmed against remote state.
- Verification belongs to the delivered revision; remaining limits are visible.
- The user has the commit or change request reference.
Use flow-release for requested versioned publication, flow-pr-fix for later review feedback
or flow-git-fix for a demonstrated Git problem.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

