---
title: "kunchenguid&#x2F;firstmate skills · skilld"
canonical_url: "https://skilld.dev/gh/kunchenguid/firstmate"
meta:
  description: "Talk to one agent. Ship with a crew."
  "og:description": "Talk to one agent. Ship with a crew."
  "og:title": "kunchenguid/firstmate skills"
  "twitter:description": "Talk to one agent. Ship with a crew."
  "twitter:title": "kunchenguid/firstmate skills"
---

`

[All skills](https://skilld.dev/skills)

[![kunchenguid avatar](https://skilld.dev/_img/avatar?url=https%3A%2F%2Fgithub.com%2Fkunchenguid.png)](https://skilld.dev/gh/kunchenguid)

# **kunchenguid/firstmate**

Talk to one agent. Ship with a crew.

main Updated 2 hours ago [GitHub](https://github.com/kunchenguid/firstmate)

![README badge for kunchenguid/firstmate](https://skilld.dev/b/kunchenguid/firstmate?theme=light&label=0)

## Repository statistics

- Indexed skills

  **19**
- Skill groups

  **1**
- GitHub stars

  **7,422**
- Forks

  **2,368**

## Skills

19 total

Sort skills

[<h3>**/afk**</h3>Enter the away posture when the captain invokes /afk, says they are going afk, \`state/.afk-contract\` or \`state/.afk\` exists, an incoming message starts with \`FM\_INJECT\_MARK\`, or any \`state/.subsuper-\*\` marker is involved. It writes the durable away-posture record with the captain's away words verbatim as the whole mandate in the same turn as /afk, before any other work and without waiting for a further go, reads the words back in plain sentences after entry, announces hold-for-return only at entry, keeps the one supervision session running in the away posture (on Pi the supervision branch acts on the words by its own judgment and takes every safe actionable wake with main parked, as the supervision host does on a non-Pi home that runs it; the daemon still delivers batched digests elsewhere for now), and on the first unmarked message renders the return brief from durable records before ordinary work resumes. /afk](https://skilld.dev/gh/kunchenguid/firstmate/afk)

Updated 2 days ago

[<h3>**/secondmate-provisioning**</h3>Agent-only reference for persistent secondmate setup and retirement. Use when creating, seeding, validating, launching, recovering, handing backlog to, pushing inherited local material into, or retiring a secondmate home, or when editing data/secondmates.md. Covers local leases, whole-home remote routes, transactional seeding, record intake for an existing or inherited domain, project clone restrictions, secondmate harness pins, inherited local-material push, idle charter, handoff helper, and teardown safety. /secondmate-provisioning](https://skilld.dev/gh/kunchenguid/firstmate/secondmate-provisioning)

Updated 2 days ago

Requires [/updatefirstmate](https://skilld.dev/gh/kunchenguid/firstmate/updatefirstmate)

[<h3>**/process-event-sources**</h3>Agent-only procedure for registered process-to-event sources and their wakes. Use before arming a long-polling source firstmate owns, before registering a deterministic condition->action watch, on any \`procevent \<adapter> \<source-id> \<sequence>\` check wake, and on any \`process-event source stranded\` or \`process-event source failed to start\` check wake. Owns the arming commands, the condition->action eligibility boundary, the durable result read, which wakes must be routed to their adapter instead of acknowledged generically, the handled acknowledgement contract, the one-owner rule, and the precise durability boundary. /process-event-sources](https://skilld.dev/gh/kunchenguid/firstmate/process-event-sources)

Updated 2 days ago

[<h3>**/ahoy**</h3>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. /ahoy](https://skilld.dev/gh/kunchenguid/firstmate/ahoy)

Updated 3 days ago

[<h3>**/bootstrap-diagnostics**</h3>Agent-only handling playbook for session-start bootstrap diagnostics. Use whenever the session-start digest's bootstrap or network-checks section prints an actionable diagnostic line - MISSING, MISSING\_MANUAL, 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, or when a standalone bin/fm-bootstrap.sh or bin/fm-startup-network.sh run prints one of those lines. A silent bootstrap section, or any other BOOTSTRAP\_INFO fact, means no skill load. /bootstrap-diagnostics](https://skilld.dev/gh/kunchenguid/firstmate/bootstrap-diagnostics)

Updated 5 days ago

[<h3>**/firstmate-coding-guidelines**</h3>Agent-only reference for changing firstmate's shared, tracked material per AGENTS.md section 1. Use before editing any of that material, whether working as firstmate directly or as a crewmate briefed on a firstmate-repo task. Covers the knowledge-placement decision tree, the one-owner rule for contracts, the inline-stub pattern for content moved into a skill, AGENTS.md size discipline, trigger hygiene for new skills, and repo style rules (one sentence per line, plain dash, no agent co-author, shellcheck-clean bin scripts, colocated tests, and maintainer-verification evidence). /firstmate-coding-guidelines](https://skilld.dev/gh/kunchenguid/firstmate/firstmate-coding-guidelines)

Updated 5 days ago

Requires [/afk](https://skilld.dev/gh/kunchenguid/firstmate/afk)

[<h3>**/fmx-respond**</h3>Agent-only playbook for handling Relay mentions and follow-ups. Use on an "x-mention \<request\_id>" check wake to read the stashed mention, classify it, act autonomously on eligible requests, reply or dismiss, and link spawned work. Also use on an "x-mode-error ..." check wake to report the Relay configuration blocker instead of answering a mention. Also use on milestone and terminal wakes for a Relay-linked task before posting completion follow-ups, using typed promised-final reconciliation when registered and --final otherwise. Also use on a "public-followup ..." check wake, and whenever a promised final public reply must be created, reconciled, or delivered. Loaded only when Relay is enabled. /fmx-respond](https://skilld.dev/gh/kunchenguid/firstmate/fmx-respond)

Updated 5 days ago

[<h3>**/firstmate-codexapp**</h3>Agent-only playbook for coordinating visible Codex Desktop threads alongside Firstmate without pretending they are a selectable shell backend. Use before creating, reading, steering, archiving, debugging, or reviewing a Codex App visible thread for Firstmate work, and before responding to requests to make Codex App native to Firstmate. /firstmate-codexapp](https://skilld.dev/gh/kunchenguid/firstmate/firstmate-codexapp)

Updated 5 days ago

[<h3>**/project-management**</h3>Agent-only procedure for Firstmate project management. Use before adding, creating, removing, or initializing a project. Cloning or registering a project is add intake and uses the same trigger. Owns project add, create, clone, remove, initialization, registry, delivery-mode, autonomy, and outward-consent decisions. /project-management](https://skilld.dev/gh/kunchenguid/firstmate/project-management)

Updated last week

[<h3>**/harness-adapters**</h3>Agent-only reference for firstmate harness operations. Use before spawning or recovering a crewmate or secondmate, handling a trust dialog, sending a harness-specific skill invocation, interrupting or exiting an agent, resuming an exited agent, or verifying a new harness adapter. Contains verified facts for claude, codex, opencode, pi, pi-signed, grok, kimi, cursor, gemini, muse, rovo, omp, agy, and devin. /harness-adapters](https://skilld.dev/gh/kunchenguid/firstmate/harness-adapters)

Updated last week

[<h3>**/stuck-crewmate-recovery**</h3>Agent-only playbook for stuck or missing ordinary Firstmate direct reports. Use when the session-start digest reports an ordinary direct report's endpoint dead or its metadata has no window, or after a stale wake, looping pane, repeated confusion, an answered-by-brief question, an unresponsive crewmate, or a failed steer. Also use on the inverse case: a live crewmate reporting the no-mistakes pipeline dead, unreachable, or timed out. Reconciles recorded work before escalating from targeted inspection through safe relaunch or failure. /stuck-crewmate-recovery](https://skilld.dev/gh/kunchenguid/firstmate/stuck-crewmate-recovery)

Updated last week

[<h3>**/quota-array-dispatch**</h3>Agent-only decision procedure for resolving a matched crew-dispatch profile array from quota-axi's default TOON, ranking by spendPriority after three orthogonal gates. Load when a dispatch rule or default resolves to more than one profile candidate. /quota-array-dispatch](https://skilld.dev/gh/kunchenguid/firstmate/quota-array-dispatch)

Updated last week

[<h3>**/bearings**</h3>Generate a "pick up where I left off" fleet digest from firstmate's live fleet state. Use when the captain invokes /bearings or asks for a bearings report, morning brief, status report, catch-up, "where did I leave off", or "what's in the works". Plain /bearings is chat-only by default, /bearings file explicitly writes the dated data/status-report-\<YYYY-MM-DD>.md artifact, and /bearings lavish additionally builds and arms the interactive fleet board; live PR enrichment remains opt-in and composes with the other modes. Also use on a contributions check wake or when filing work linked to an upstream issue. Also load this skill's board-wake handling when a procevent lavish wake's source id matches the canonical source id of the stable bearings board path. /bearings](https://skilld.dev/gh/kunchenguid/firstmate/bearings)

Updated 2 weeks ago

Requires [/afk](https://skilld.dev/gh/kunchenguid/firstmate/afk)

[<h3>**/updatefirstmate**</h3>Self-update a running firstmate and its secondmates to the latest from origin. Use when the captain invokes /updatefirstmate (e.g. "/updatefirstmate", "update firstmate", "pull the latest firstmate"). Updates this firstmate repo's default branch and every local or remote secondmate through its guarded convergence path (never forced, never disruptive), then re-reads AGENTS.md and restarts every live second mate through the persist-gated restart, with a fallback re-read nudge only where a restart cannot be proven. /updatefirstmate](https://skilld.dev/gh/kunchenguid/firstmate/updatefirstmate)

Updated 2 weeks ago

[<h3>**/ask-user-authority**</h3>Agent-only decision procedure for ask-user findings. Use before deciding any ask-user finding. This skill is the single owner of finding-decision policy: firstmate always applies judgment, decides findings that are unambiguous toward accepted intent, and escalates only genuinely ambiguous, expanding, or destructive ones. Finding authority is this skill's criteria, not the project's yolo posture. /ask-user-authority](https://skilld.dev/gh/kunchenguid/firstmate/ask-user-authority)

Updated last month

[<h3>**/firstmate-orca**</h3>Agent-only operator checklist for Firstmate's Orca runtime backend. Use when switching to Orca, spawning or supervising Orca-backed work, smoke-testing Orca backend behavior, debugging Orca task state, or reconciling Orca-backed task metadata. /firstmate-orca](https://skilld.dev/gh/kunchenguid/firstmate/firstmate-orca)

Updated last month

[<h3>**/stow**</h3>Sweep the current conversation for durable knowledge - user preferences, project facts, operational gotchas, standing decisions, and unfinished next steps - and file each through explicit instructions, existing local conventions, or the private \`.stow-notes.md\` fallback, curating tiered, decaying destination files as it writes. Use when the user invokes /stow, asks to save or write down what was learned this session, or before a context reset or long break. /stow](https://skilld.dev/gh/kunchenguid/firstmate/stow)

Updated last month

[<h3>**/decision-hold-lifecycle**</h3>Renamed pointer kept for in-flight briefs: the decisions concept collapsed into "a task held for the captain". Load captain-hold-lifecycle instead; this stub only redirects and will be removed one release after the collapse. /decision-hold-lifecycle](https://skilld.dev/gh/kunchenguid/firstmate/decision-hold-lifecycle)

Updated last month

[<h3>**/diagnostic-reasoning**</h3>Agent-only procedure for diagnosing reported bugs. Use before scoping a reported bug and before acting on a diagnostic report. Owns end-user-aligned reproduction, causal separation, divergent-path and history inspection, counterfactual testing, and disconfirming evidence. /diagnostic-reasoning](https://skilld.dev/gh/kunchenguid/firstmate/diagnostic-reasoning)

Updated 3 months ago

## Add to your README

The badge links readers to this page. It shows the skilld mark and no counts, and it follows the reader's light or dark GitHub theme.

`<a href="https://skilld.dev/gh/kunchenguid/firstmate"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://skilld.dev/b/kunchenguid/firstmate?theme=dark"> <source media="(prefers-color-scheme: light)" srcset="https://skilld.dev/b/kunchenguid/firstmate?theme=light"> <img alt="Skill repository on skilld.dev" src="https://skilld.dev/b/kunchenguid/firstmate?theme=light"> </picture> </a>`