feat(skills): add captain-invocable /quiet skill for end-of-turn-only replies

.agents/skills/quiet/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: quiet
+description: >-
+  Keep firstmate silent until the final captain-facing reply for the current session.
+  Use when the captain invokes /quiet, or says "stay quiet", "no chatter", or "silent until done".
+  Turn off with /quiet off or "talk normally".
+user-invocable: true
+metadata:
+  internal: true
+---
+
+# quiet
+
+Session-scoped silence for captain chat.
+This skill owns when firstmate may speak to the captain while quiet is on; Calm owns built-in tool-row presentation separately.
+
+## On and off
+
+- **On:** `/quiet`, or natural language such as "stay quiet", "no chatter", or "silent until done".
+- **Off:** `/quiet off`, or "talk normally".
+- Quiet lasts for the rest of this session until turned off.
+- Do not write flags, files, or config for it.
+
+## While quiet is on
+
+1. Run tools as usual.
+2. Do not send mid-turn captain-facing messages: no progress chatter, no "checking…", no "need the URL…", no partial status.
+3. Send exactly one captain-facing reply at the end of the turn, after tool work for that turn is done.
+4. Truth still beats silence: that final reply must still report a real blocker, needed credential, failed action, or other captain-needed outcome from the turn.
+5. Section 9 captain etiquette still applies to that final reply.
+
+## Honest limit
+
+Pi Calm can hide built-in tool rows; MCP and custom tool rows (including lean-ctx `ctx_*`) stay visible because Pi does not expose a renderer wrap for them.
+Never claim those rows are hidden.
+Do not wrap MCP tools, add a CLI, or change Calm's hide contract to fake silence.
+
+## Confirmations
+
+When turning quiet on or off, one short captain-facing sentence is enough (for example that quiet is on until `/quiet off`, or that normal talk is restored).

AGENTS.md

@@ -464,6 +464,7 @@ Reach the captain immediately for:
 
 Do not surface automatic fixes, retries, routine progress, or internal supervision mechanics.
 When a routine operational update's specific event requires no action but a response must be sent, reply exactly `Captain, shipshape.` without characterizing the visible session's unrelated decisions.
+When the captain invokes `/quiet` or asks to stay quiet until done, load the `quiet` skill; it owns session-scoped silence until the final captain-facing reply.
 Batch non-urgent updates into the next natural reply.
 Use plain chat for a yes-or-no decision and `lavish-axi` only when several options or a structured report benefit from a visual surface.
 Whenever a PR is mentioned, include its full `https://...` URL before any shorthand reference.

README.md

@@ -172,6 +172,7 @@ Claude and grok use the slash form shown here; codex uses the same names with `$
 | `/afk`             | Enter away-mode supervision: the sub-supervisor self-handles routine notifications in bash, escalates captain-relevant events and bounded declared-external-wait rechecks as batched digests, and actively alerts if delivery gets stuck while you step away |
 | `/ahoy`            | Recap visible session events since the prior real captain message plus visibly unanswered captain decisions, then guide the captain through any open decisions one at a time in agent-judged impact order; fall back to Bearings when invoked as the session's first real captain message |
 | `/bearings`        | Generate a concise four-section chat digest from bounded local fleet and registered-secondmate state; use `/bearings file` to also replace today's dated report in `data/`, and add `include PRs` when live PR enrichment is wanted |
+| `/quiet`           | Stay silent until one captain-facing reply at the end of the turn: tools still run, mid-turn chatter stops, and that final reply still reports blockers, needed credentials, and failures; turn off with `/quiet off` or "talk normally" |
 | `/updatefirstmate` | Self-update the running firstmate and its secondmates to the latest from origin with fast-forward-only pulls, then re-read instructions and nudge secondmates |
 | `/stow`            | Sweep the session for uncaptured durable knowledge, curate tiered startup memory with decay and cold archival, enforce each home's budget or surface the required decision, cascade to registered second mates, and report what is safe to reset |
 

docs/documentation-audiences.json

@@ -164,6 +164,10 @@
       "path": ".agents/skills/project-management/SKILL.md",
       "audience": "agent-runtime"
     },
+    {
+      "path": ".agents/skills/quiet/SKILL.md",
+      "audience": "agent-runtime"
+    },
     {
       "path": ".agents/skills/quota-array-dispatch/SKILL.md",
       "audience": "agent-runtime"