ship-landing
Skill2 starsChanged 32 days agoMITView on GitHub
Load when a ship reports a PR or ready branch, when deciding or monitoring landing, and before task cleanup.
2 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- kunchenguid/firstmateedited, first seen Oct 8, 2026
- Blink-h/agent-startup-kittheir own version, first seen Apr 17, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- kunchenguid/firstmate★ 8.7k82% same
Wrote their own version · 1
- Blink-h/agent-startup-kit★ 202same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- afkSkill
- agent-skill-trigger-indexSkill
- ahoySkill
- ask-user-authoritySkill
- away-quiet-supervisionSkill
- bearingsSkill
- bootstrap-diagnosticsSkill
- captain-hold-lifecycleSkill
- control-firstmateSkill
- decision-hold-lifecycleSkill
- diagnostic-reasoningSkill
- firstmate-codexappSkill
- firstmate-coding-guidelinesSkill
- firstmate-orcaSkill
- fmx-respondSkill
- harness-adaptersSkill
- operational-home-layoutSkill
- process-event-sourcesSkill
- project-managementSkill
- quietSkill
- quota-array-dispatchSkill
- scout-completionSkill
- secondmate-provisioningSkill
- session-start-recoverySkill
- stowSkill
- stuck-crewmate-recoverySkill
- updatefirstmateSkill
- validation-supervisionSkill
- verify-firstmateSkill
- stowSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Run bin/fm-pr-check.sh <id> <PR url> with the URL copied from that ready signal or the resolved checks-green fm-crew-state.sh line - it …
- Distinctive: line 25
Never force teardown without explicit discard authority.
- Distinctive: line 26
After successful teardown, record completion, retain only the configured recent Done history, and re-evaluate queued work whose blockers …
≈ “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 landing
For PR-based ship tasks, the ready signal depends on mode: no-mistakes reports done [at=<epoch>]: PR <url> checks green after CI is green, while direct-PR reports done [at=<epoch>]: PR <url> after opening the PR, each only for a non-draft PR; a lane that deliberately holds a draft declares a wait instead, and bin/fm-pr-check.sh refuses to arm merge monitoring on a draft.
Run bin/fm-pr-check.sh <id> <PR url> with the URL copied from that ready signal or the resolved checks-green fm-crew-state.sh line - it records pr= and the forge's pr_head= when available in the task's meta and arms the watcher's merge poll.
bin/fm-dod-lib.sh owns the named-head gate on that ready signal: a ship done: whose named head exists only in the worker's disposable copy is not ready (bin/fm-crew-state.sh reports blocked, bin/fm-pr-check.sh refuses to register, and a secondmate does not publish that done upstream).
That blocked reading is the gate working, not a stuck worker, so steer the worker on the commit the refusal names rather than waiting.
A direct-PR worker pushes that commit to its PR branch, and a local-only worker commits it on its ship branch.
A no-mistakes worker re-validates it with /no-mistakes so the pipeline stays the one publisher; it never pushes from its copy.
In no-mistakes mode the earlier done [at=<epoch>]: {summary} is the pipeline handoff and is not gated.
Tell the captain the PR's full https://... URL copied from the worker's ready line, the resolved checks-green crew-state line, or the task's pr= metadata, a concise outcome summary, and the no-mistakes risk level when applicable.
A captain instruction to merge is explicit authority; yolo is the only standing routine merge authority.
For any custom state/<id>.check.sh you write yourself, keep it an ordinary single-link mode-0700 file, print one line only when firstmate should wake, print nothing otherwise, finish before FM_CHECK_TIMEOUT, then bind its current bytes with bin/fm-check-register.sh <id> before the watcher may execute it.
Retire a custom check only through bin/fm-check-unregister.sh <id> (or bin/fm-teardown.sh for a spawned task); never hand-compose an rm with $STATE/$ID.
Tear down a ship task only after landing is confirmed. A teardown refusal for uncommitted or unlanded work is a stop-and-investigate result, never an obstacle to bypass. Never force teardown without explicit discard authority. After successful teardown, record completion, retain only the configured recent Done history, and re-evaluate queued work whose blockers and time gates have cleared.
A secondmate is persistent and an empty queue is healthy.
Retire one only on an explicit captain or main-firstmate decision, after loading secondmate-provisioning; its home must contain no work under way, and forced discard still requires explicit captain authority.
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.

