From 94da9d91278992f8366e6fa37a5dcafb61459ee6 Mon Sep 17 00:00:00 2001 From: Kyle Isom Date: Sat, 26 Sep 2026 20:33:19 -0700 Subject: [PATCH] skill: confirm numbers and counts from a digest with --grep; the question refusal is now only past 5000 chunks Found in the P5b prod check: "how many PIO state machines in total?" on the RP2040 datasheet came back 4 (bm25 and hybrid); the answer, 8, is a terse bullet on p. 9 that --grep finds at once. Co-Authored-By: Claude Opus 5.5 --- skill/SKILL.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/skill/SKILL.md b/skill/SKILL.md index 6366e55..1b3c381 100644 --- a/skill/SKILL.md +++ b/skill/SKILL.md @@ -66,11 +66,14 @@ long one comes back as a map — an outline with page numbers, then the first pa - `sift fetch URL --pages 41-60` for a page range, `--grep 'pattern'` for matching lines, or `--question "…"` for a digest that cites each fact as `(p. N)`; `--question` works on long PDFs, and the first answer may be `bm25` (lexical) — ask again later for a sharper one. +- A digest reads only the ~5 passages that looked most relevant, so it can miss a fact that + sits in a terse list elsewhere (a feature summary, a spec table). **Before you rely on a + number, a count or a spec from a digest, confirm it with `--grep`** and quote that line. - Scanned PDFs have no text layer: sift reports `no text layer (scanned PDF?)` — point it at an OCR source rather than trying to fix it here. -- A range returns at most 100 pages and grep at most 100 matches. On a very long document - `--question` is refused with `document too long for question (N chunks); use grep or pages` — - do that: `--grep` for the terms, then `--pages` around the hits. +- A range returns at most 100 pages and grep at most 100 matches. On an extremely long document + (over 5000 chunks) `--question` is refused with `document too long for question (N chunks); + use grep or pages` — do that: `--grep` for the terms, then `--pages` around the hits. Never download a PDF and run `pdftotext` yourself; `sift` is the sanctioned extractor.