# Bootstrap Diagnostics

Load when the session-start digest's bootstrap or network-checks section, or a...

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

## Install

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

## Description

Load when the session-start digest's bootstrap or network-checks section, or a standalone bin/fm-bootstrap.sh or bin/fm-startup-network.sh run, prints an actionable diagnostic line - MISSING, MISSING_MANUAL, OUTDATED, PRESENTATION_UNAVAILABLE, BACKEND_INVALID, NEEDS_GH_AUTH, TANGLE, STARTUP_MEMORY_BUDGET, CREW_DISPATCH invalid, FLEET_SYNC, NETWORK_CHECKS, HOME_SUMMARY, BACKLOG_RECONCILE, SECONDMATE_SYNC, SECONDMATE_LIVENESS, SECONDMATE_HANDOFF, NUDGE_SECONDMATES, or FMX - or reports that an interrupted backlog cleanup may have left an endpoint or local copy. A silent bootstrap section, or any other BOOTSTRAP_INFO fact, means no skill load.

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

# bootstrap-diagnostics

Handle each printed line as below, before dispatching work that depends on it.
The line formats themselves are owned by `bin/fm-bootstrap.sh`'s header; this playbook owns the response to actionable lines.
The session-start rules in `session-start-recovery` still bind: detect, then consent, then install or upgrade - never change a tool the captain has not approved in this session - and no work is dispatched until the tools it needs are present and GitHub auth is good.
When any diagnostic needs captain attention, report the plain consequence and requested action using `AGENTS.md` section 9's captain-facing translation contract; do not name the diagnostic label unless the captain needs to paste it into a command or issue.

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