Skip to content

docs: tailor imsg skill for OpenClaw agents #100105

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
omarshahine merged 4 commits into from
Jul 5, 2026
+184 −57
Merged

docs: tailor imsg skill for OpenClaw agents #100105

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9fe8a7e
docs: tailor imsg skill for OpenClaw agents
omarshahine Jul 4, 2026
d86f844
docs(imsg-skill): document that poll send echoes --question as a visi…
omarshahine Jul 5, 2026
3a0c866
docs(imsg-skill): note inbound native poll question is backfilled fro…
omarshahine Jul 5, 2026
01e9c38
docs(imsg-skill): document only shipped poll behavior
omarshahine Jul 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
docs(imsg-skill): document that poll send echoes --question as a visi… 
…ble comment
  • Loading branch information
@omarshahine
omarshahine committed Jul 5, 2026
commit d86f844ee211fae277a7fd068ec653cb5ee9b81f
5 changes: 5 additions & 0 deletions skills/imsg/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -205,9 +205,14 @@ Use `send-rich --reply-to <message-guid>` for threaded replies. Confirm the refe

Native Apple Messages polls require the bridge. Creation needs at least two `--option` values. Voting requires one of `--option-id`, `--option-index`, or `--option`.

Messages renders only the options on a poll balloon — the poll title is never shown to recipients. So `poll send` automatically echoes `--question` as a reply comment on the poll (a text whose `reply_to` is the poll guid, exactly what the native "comment or Send" field produces). Just set `--question` and the visible caption appears for free — no extra step. Use `--comment` only to make the visible caption differ from the stored title.

```bash
imsg poll send --chat 'iMessage;-;+15551234567' \
--question "Dinner?" --option "Pizza" --option "Sushi"
# --comment overrides the echoed caption when it should differ from --question:
imsg poll send --chat 'iMessage;-;+15551234567' \
--question "Dinner?" --comment "Vote by 5pm 🍽️" --option "Pizza" --option "Sushi"
imsg poll send --chat 'iMessage;+;chat0000' --reply-to <message-guid> \
--question "Approve?" --option "Yes" --option "No"
imsg poll vote --chat 'iMessage;+;chat0000' \
Expand Down
Loading