Send Message
Productivitysend-messageSend Message is an Agent Skill for productivity published in the rcarmo/piclaw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Send a message to the chat immediately without waiting for the current task to finish. Useful for acknowledging requests or sending progress updates while working.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/rcarmo/piclaw/blob/HEAD/skel/.pi/skills/send-message/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/send-message-249c5edb, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Send a Message
Write an IPC JSON file so piclaw sends a message immediately.
Usage
cat > "$PICLAW_DATA/ipc/messages/msg_$(date +%s)_$$_send.json" <<EOF
{
"type": "message",
"chatJid": "$PICLAW_CHAT_JID",
"text": "Your message here",
"media": [
{
"path": "/absolute/path/to/chart.svg",
"content_type": "image/svg+xml",
"inline": true
}
]
}
EOF
When to use
- acknowledge a request before longer work starts
- send progress updates during a multi-step task
- deliver partial results while continuing to work
Example progress message:
Processing 3/10 files, ~30s remaining…
Notes
- Messages are usually picked up within ~1 second.
- The IPC file is deleted after successful delivery.
- Use WhatsApp-compatible formatting for WhatsApp-bound chats:
*bold*,_italic_,• bullets, and fenced code blocks. - You can attach local media files with an optional
mediaarray.- each item is
{ path, content_type?, filename?, inline? } pathmust point to an existing readable filecontent_typeandfilenameoverride detected valuesinline: truehints inline rendering for supported images
- each item is
- Missing or unreadable media paths generate an inline warning and do not block delivery of the remaining files.
- Do not use this for your final conversational response.
- Edge case: if the main deliverable is a file or image, send it via IPC if needed, then still return a brief normal response confirming what was sent.
Environment
PICLAW_DATA— piclaw data directory (containsipc/messages/)PICLAW_CHAT_JID— JID of the chat that triggered this invocation