agentleFS
emiliodominguezemiliodominguez/flow-skills/skills/flow-ship/SKILL.md

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`.

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
  1. Distinctive:

    Read current authorization, repository delivery rules, branch/remotes, status and existing change request metadata.

    line 15
  2. Very specific:

    Run the pre-launch checklist: required format, lint, types, tests, build, generated docs and relevant runtime checks.

    line 24
  3. Distinctive:

    Run each check fresh and read its output before reporting it.

    line 26
  4. Very specific:

    Use atomic commits under the conventional-commit policy of flow-commit.

    line 32
  5. Distinctive:

    After a failed plain commit, fix and create a new commit.

    line 33
  6. Very specific:

    Verify the remote SHA, change request URL, draft/ready/merged state and check summary.

    line 53
  7. Very specific:

    Use flow-release for requested versioned publication, flow-pr-fix for later review feedback or flow-git-fix for a demonstrated Git problem.

    line 70

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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-review where 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.