From be401a2d4917913ea8037581e7da12287f934d49 Mon Sep 17 00:00:00 2001 From: leemour Date: Tue, 17 Nov 2026 17:44:09 +0100 Subject: [PATCH] docs(skill): join word variants with OR in search messages Plain words in search messages must all match, so an agent unsure of the exact word got nothing back from several spellings in one search. One line in the skill's question path says so and shows the OR form. SKILL.md stays under its 9 KiB limit (8,992 bytes). Co-Authored-By: Claude Opus 5.5 --- changes/docs-skill-search-or.md | 5 +++++ skills/tg-cli/SKILL.md | 3 ++- 2 files changed, 7 insertions(+), 1 deletion(-) create mode 100644 changes/docs-skill-search-or.md diff --git a/changes/docs-skill-search-or.md b/changes/docs-skill-search-or.md new file mode 100644 index 00000000..2f4fd934 --- /dev/null +++ b/changes/docs-skill-search-or.md @@ -0,0 +1,5 @@ +### Fixed + +- **The agent skill says that every word of `search messages` must match, and to join variants with a capital OR** + (`invoice OR счёт`) when it is unsure which word a message uses. Several spellings in one search found only the + messages that hold all of them. diff --git a/skills/tg-cli/SKILL.md b/skills/tg-cli/SKILL.md index b88817e4..1ba478d5 100644 --- a/skills/tg-cli/SKILL.md +++ b/skills/tg-cli/SKILL.md @@ -37,7 +37,8 @@ Choose a path from the user's task rather than reading recent messages by defaul named); do not cut it to one word. When the owner says "I advised / I wrote", add `from:me`. 2. Then `tg personal search messages "" --discover --json`, then key words with `tg personal search messages ""` (this machine's copy plus Telegram's own search). Add - `--backend archive` when the owner wants nothing to leave the machine. + `--backend archive` when the owner wants nothing to leave the machine. Every word must match; unsure which + word the message uses, join the variants with a capital OR: `invoice OR счёт`, `colour OR color`. 3. **Never filter the results yourself** (`grep -v`, `jq select`) by chat or sender: a hit in a chat you did not expect is often the answer. The first result and its score do not establish an answer. 4. **Read around a hit:** `tg personal messages context `. `messages show` and `messages context`