# Ahoy

Recap visible session events and guide the captain through visibly unanswered decisions...

- Repository: https://github.com/kunchenguid/firstmate (8480 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kunchenguid/firstmate --skill ahoy -g -a claude-code -y`
Codex: `npx skills add kunchenguid/firstmate --skill ahoy -g -a codex -y`
Cursor: `npx skills add kunchenguid/firstmate --skill ahoy -g -a cursor -y`
Gemini CLI: `npx skills add kunchenguid/firstmate --skill ahoy -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ahoy

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

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

The rest: https://github.com/kunchenguid/firstmate/blob/HEAD/.agents/skills/ahoy/SKILL.md