sync skills from clawdbot

tools/imsg/skills/imsg/SKILL.md

@@ -23,24 +23,52 @@ metadata:
   }
 ---
 
-# imsg
+# imsg Actions
+
+## Overview
 
 Use `imsg` to read and send Messages.app iMessage/SMS on macOS.
 
-Requirements
+Requirements: Messages.app signed in, Full Disk Access for your terminal, and Automation permission to control Messages.app for sending.
 
-- Messages.app signed in
-- Full Disk Access for your terminal
-- Automation permission to control Messages.app (for sending)
+## Inputs to collect
 
-Common commands
+- Recipient handle (phone/email) for `send`
+- `chatId` for history/watch (from `imsg chats --limit 10 --json`)
+- `text` and optional `file` path for sends
 
-- List chats: `imsg chats --limit 10 --json`
-- History: `imsg history --chat-id 1 --limit 20 --attachments --json`
-- Watch: `imsg watch --chat-id 1 --attachments`
-- Send: `imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg`
+## Actions
 
-Notes
+### List chats
+
+```bash
+imsg chats --limit 10 --json
+```
+
+### Fetch chat history
+
+```bash
+imsg history --chat-id 1 --limit 20 --attachments --json
+```
+
+### Watch a chat
+
+```bash
+imsg watch --chat-id 1 --attachments
+```
+
+### Send a message
+
+```bash
+imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
+```
+
+## Notes
 
 - `--service imessage|sms|auto` controls delivery.
 - Confirm recipient + message before sending.
+
+## Ideas to try
+
+- Use `imsg chats --limit 10 --json` to discover chat ids.
+- Watch a high-signal chat to stream incoming messages.