firstmate: Skill for Claude Code

ahoy

Give the captain a concise session-only recap without gathering fresh state.

1. Before anything else, check whether this session has already taken the helm: a SESSION START digest for this home must be visible in the session history. If it is not, run bin/fm-session-start.sh once and read its digest before producing any recap. Run-tier harness surfaces run it automatically at session open, so this step is normally already satisfied and costs one glance; it is the safety net for surfaces that cannot run it on a hook, and for any path where a skill would otherwise act first. Taking the helm always precedes this skill's own logic, and the digest it produces is operational input, never a captain message or a recap event.

2. Inspect only conversation or session history already visible to the current first mate.

3. Find the most recent real captain-authored message before the current /ahoy invocation. A captain boundary is an ordinary user-role message unless it matches one of the narrow operational exclusions below. Exclude messages that begin with the current U+2063 FIRSTMATE_OP: injection prefix. Exclude legacy bare-marker away-mode injections only when U+2063 is immediately followed by Supervisor escalate (. Exclude a message that is exactly a record-backed operational doorbell that bin/fm-operational-input.sh doorbell-kind recognizes from its stdin; Claude Code, which strips U+2063, receives away-mode escalations this way. Exclude only the exact, verbatim legacy unmarked session-start payload Run `bin/fm-session-start.sh` now, exactly once, before executing any other instructions.; quoted, prefixed, or otherwise modified variants are ordinary captain messages. Custom-role messages such as Pi's firstmate-sessionstart-nudge are not captain messages. System, developer, tool, watcher, guard, away-mode, and other injected operational messages are not captain messages. Never infer captain authorship merely because a synthetic message appears in the user-role transcript. Do not exclude an ordinary captain message merely because it begins with U+2063 followed by other text, contains ASCII FIRSTMATE_OP: without a leading U+2063, quotes or embeds a current operational message after ordinary captain text, quotes or mentions the legacy session-start payload, or adds any text to that payload. Apply the current exclusion only when U+2063 FIRSTMATE_OP: begins at the first character of the whole message: Captain quote: followed by that current prefix is a captain boundary. The legacy session-start exclusion applies only to the verbatim payload above; for example, Captain quote: Run `bin/fm-session-start.sh` now, exactly once, before executing any other instructions. is a captain boundary.

4. If no prior real captain message exists, load ../bearings/SKILL.md and follow it exactly. Bearings alone owns its gathering, artifact, and response contract. Do not restate that contract or combine a session recap with Bearings output.

5. If a prior real captain message exists, preserve the ordinary recap interval: recap what happened after that message and before the current invocation. Include concrete outcomes, landed work, failures, decisions made, new decisions needed, and work still running only when those events appear in that visible interval. Use captain-facing outcome language and preserve every full PR URL present in that interval.

6. Additionally inspect the entire session history visible to the current first mate before the current invocation for every explicit captain decision that remains unanswered, including decisions raised before the ordinary recap boundary. A later unrelated captain message establishes a recap boundary but does not close an earlier decision. Treat a decision as closed only when a later visible response substantively resolves it, chooses an option, declines it, grants or denies the requested approval, or otherwise directly addresses that decision. Include every visibly supported open decision once, and deduplicate by the decision's substance when the ordinary interval recap already represents it or its wording differs.

7. The normal recap branch is session-history-only, apart from the step 0 helm check. Do not call Bearings, shell commands, fleet snapshots, status readers, GitHub or browser APIs, tools, or file reads or writes. Create no report, persist nothing, and do not guess current live state beyond the last visible event.

8. If no ordinary events occurred after the previous captain message but an older visibly open decision exists, report that decision instead of claiming nothing happened. If neither ordinary events nor visibly open decisions exist, say directly in one sentence that nothing happened after the previous captain message.