docs(skill): document only shipped poll behavior

omarshahine · claude · omarshahine · commit 4e5aa724008b · 2026-07-05T09:16:15.000-07:00
The poll caption echo, --comment override, and inbound question backfill live in #155, not on main (shipped imsg 0.12.2 'poll --help' has no --comment). Drop those claims so the skill documents only shipped behavior and can merge independently of #155. Tracked by #157 to re-add once #155 lands. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011dTDUtxanzs8NDhTD862QV
diff --git a/.agents/skills/imsg/SKILL.md b/.agents/skills/imsg/SKILL.md
@@ -72,13 +72,11 @@ Only after `imsg status` confirms the bridge is loaded (`imsg launch` injects it
 
 ```bash
 imsg send-rich --chat 'iMessage;-;+15551234567' --text 'hi' --reply-to MSG_GUID   # replies, effects, subjects
-imsg poll send --chat GUID --question 'Dinner?' --option 'Pizza' --option 'Sushi'  # --question auto-shows as a poll comment
+imsg poll send --chat GUID --question 'Dinner?' --option 'Pizza' --option 'Sushi'  # native Messages poll; --question + 2+ --option
 imsg edit --chat GUID --message MSG_GUID --new-text 'updated'                     # macOS 13+
 imsg chat-create --addresses '+15551234567,+15559876543' --name 'Crew'
 ```
 
-Native poll balloons show no title, so `poll send` sends `--question` as a plain caption message right after the poll — what recipients actually see (`--comment` overrides). The reverse holds on read: `imsg history`/`watch` backfill an inbound native poll's `question` from its caption, so a received poll surfaces its real question instead of an empty one.
-
 Destructive bridge commands — `unsend`, `delete-message`, `chat-delete`, `chat-leave`, `chat-remove-member` — need per-action user confirmation.
 
 ## Verification
