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.