From fe3f9dae75de0c689037f1c35fce0d2d85095c55 Mon Sep 17 00:00:00 2001 From: Dan Connolly Date: Wed, 7 Oct 2026 02:51:47 -0500 Subject: [PATCH] watchme: trim description to triggers; drop dangling references The description repeated the body's procedure (which file, the losing diagnosis, the exact winning? replies). Keep only trigger phrases and artifact names, and add two missed triggers: reading a recording without the magic words, and how to set one up. Drop the link to ../lab-notebook-template.md and the mention of a `watchme` specimen capture; neither exists in this repo. Generated-by: Claude Opus 5.5 --- watchme/SKILL.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/watchme/SKILL.md b/watchme/SKILL.md index 7d09727..d5a7fd8 100644 --- a/watchme/SKILL.md +++ b/watchme/SKILL.md @@ -1,6 +1,6 @@ --- name: watchme -description: Use when the operator says "watch me", "losing", or "winning?" about a session recorded with `script -f xyz.script` — the typescript is shared ground truth. Unless otherwise stated, the newest `.tmp/*.script` is the file to look at. For "losing", read the tail for what was done and what the machine said, diagnosing from evidence instead of asking for a re-telling. For "winning?", answer one of exactly "Yes, that's as expected; next, do X." or "Yes, as expected. Done!" — no partial verdicts. +description: Watch me — terminal / shell session recorded with `script -f` (a typescript, `.tmp/*.script`) as shared ground truth. Use when the operator says "watch me", "losing", or "winning?"; when diagnosing a shell session from its recorded transcript instead of asking for a re-telling; when asked how to record a terminal session. --- # Watch Me: a typescript as shared ground truth @@ -60,8 +60,7 @@ Script done on 2026-09-02 23:48:46-05:00 [COMMAND_EXIT_CODE="0"] ``` The header records when, on which TTY, and the terminal geometry; the footer -records the exit code. `watchme` is a short specimen — the smallest useful -capture, including the escape noise described below. +records the exit code. For a longer session the value is that one file holds both halves of the story: the operator's commands and the machine's responses, interleaved in @@ -69,7 +68,7 @@ order. `tail` it while it is live; `grep` it after the fact. ## Relationship to the lab notebook -The typescript is raw evidence; the [lab notebook](../lab-notebook-template.md) +The typescript is raw evidence; a lab notebook is interpretation. Read the script to establish what happened, then promote the finding — hypothesis, evidence, next question — into a notebook entry so it survives independently of the transcript.