# Session Start Recovery

Load when the session-start digest reports unfinished checks, actionable diagnostics...

- 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 session-start-recovery -g -a claude-code -y`
Codex: `npx skills add kunchenguid/firstmate --skill session-start-recovery -g -a codex -y`
Cursor: `npx skills add kunchenguid/firstmate --skill session-start-recovery -g -a cursor -y`
Gemini CLI: `npx skills add kunchenguid/firstmate --skill session-start-recovery -g -a gemini-cli -y`

## Description

Load when the session-start digest reports unfinished checks, actionable diagnostics, recovery inputs, or output requiring interpretation.

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

# Session-start recovery

The digest itself makes no external-network call and never waits for one.
Every network check a session start owes - GitHub auth, secondmate recovery, secondmate convergence, pending handoff delivery, and project clone refresh - runs off the digest's blocking path in a bounded worker owned by `bin/fm-startup-network.sh` and is reported in the digest's own `NETWORK CHECKS` section.
The locked startup inactive-outcome scan joins that worker so a slow local current-state read cannot block the digest; its findings use the ordinary durable wake queue.

The rest: https://github.com/kunchenguid/firstmate/blob/HEAD/.agents/skills/session-start-recovery/SKILL.md
