Index of every page on this site: llms.txt
All skills
kunchenguid avatar

/ahoy

@427056c
by Kun Chenkunchenguid/firstmate9k stars
2,779
Run it yourself

Recap visible session events and guide the captain through visibly unanswered decisions when the captain explicitly invokes /ahoy, with a Bearings fallback when /ahoy is the session's first real captain message.

  • 1 file
  • 6.2 KB
  • Updated last month
  • GitHub
Use this Skill: https://skilld.dev/gh/kunchenguid/firstmate/ahoy

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈54 tokens for metadata: the name and description. ≈1.5k when used: this file.

Description uses 2.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈218 characters, or 2.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

  9. After the normal recap, when the existing visibly open decision inventory contains decisions, begin a guided decision-clearing flow by presenting only the single open decision judged most impactful by the first mate. Say the ordering is the first mate's pick. Give enough escalation-quality context to decide easily: the decision, why it matters, the options, and a recommendation.

  10. When the captain answers the presented decision, present the next highest-impact decision from that existing inventory in the same form. Continue one decision at a time until none remain, without starting this flow when the inventory is empty.

The current /ahoy message is outside the recap interval. A previous /ahoy is a real captain message and may be the next interval boundary. If context compaction makes the prior boundary unavailable, state that the exact session boundary is unavailable and summarize only visibly supported events. Compacted history supports an open decision only when both its request and its still-unanswered status are visible; report uncertainty instead of reconstructing hidden requests or answers. Do not silently invoke Bearings unless this is genuinely the first real captain message.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 427056c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated last month
user-invocable
true
metadata
{
  "internal": true
}

README badge

README badge for kunchenguid/firstmate/ahoy