From c7e6476606a53c4ab33359a16e4749d7e4bc93bc Mon Sep 17 00:00:00 2001
From: Marcus <86715671+MarcusNeufeldt@users.noreply.github.com>
Date: Thu, 6 Aug 2026 09:14:16 +0200
Subject: [PATCH] docs(skill): handle first-run trust prompt after agent start

---
 skills/herdr/SKILL.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/skills/herdr/SKILL.md b/skills/herdr/SKILL.md
index fafea549c0..87996268a1 100644
--- a/skills/herdr/SKILL.md
+++ b/skills/herdr/SKILL.md
@@ -119,6 +119,16 @@ herdr agent start reviewer --kind codex --pane <returned-pane-id> -- <agent-args
 
 `agent start` returns only after Herdr detects the expected agent in the same pane and considers it ready for interactive input. It defaults to a 30-second startup timeout.
 
+A freshly launched agent may pause on a first-run prompt before it accepts input. In an untrusted directory, Codex asks "Do you trust the contents of this directory?" and waits for Enter; other agents may show onboarding or login screens. If the agent is not yet promptable, read the pane and answer the prompt:
+
+```bash
+herdr agent read <name> --source recent-unwrapped --lines 60
+herdr agent send-keys <name> enter
+```
+
+Answer "Yes, continue" for the directory trust check only when the user has asked for work in that directory; otherwise stop and ask. After answering a first-run prompt, confirm the agent is idle before sending work.
+
+
 Submit work through the agent surface:
 
 ```bash