Recipes work through a pane of their own, its look and exec, and keep a command pane while their open lasts; the docs give cmd panes, the err grep, alt-screen prompts, /pager's refusals, Tty+ on a ctl, --, and theme failures in words

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 9 insertions, 4 deletions

diff --git a/.agents/skills/pardes-9p/SKILL.md b/.agents/skills/pardes-9p/SKILL.md
index 9b963f73..4a1ddeb3 100644
--- a/.agents/skills/pardes-9p/SKILL.md
+++ b/.agents/skills/pardes-9p/SKILL.md
@@ -30,10 +30,15 @@ mount, plan9port's `9p -a "unix!$PARDES_9P"` works, and `test/ninep.py` in the s
 
 ## Traps
 
-- Check the write's status first: a refused write says only `Invalid
-  argument` or `Input/output error`, and then the last `err` record in
-  `$m/log` says why (`echo x > f || tail -1 $m/log`). A successful write
-  logs nothing, so the tail may hold an older `err`.
+- A refused write says only `Invalid argument` or `Input/output error`;
+  `grep '^err' $m/log | tail -1` says why. Not the log's last line: after
+  a refused Del, Exit or Restore that may be `+Unsaved`'s `new`.
+- Work through a pane of your own (`n=$(cat $m/pane/new)`) and its own
+  `look` and `exec`: the root's act at the active pane, which another
+  client, an idle shell or an event helper may own.
+- `head` on `index`, `layout`, `log` or `recent` through 9ns says `Illegal
+  seek`: use `sed -n 1p`. In `index`, `term` is a shell, `cmd` a command's
+  pane.
 - `addr` is the pane's and moves on: each `/re/` searches from the last
   address, and a `data` write leaves it just past the text. Write `addr`
   before each replacement; a failed address leaves none.