OpenParable
Skip to content
← Back to skills

Send Message

Productivity
send-message

Send 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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 media array.
    • each item is { path, content_type?, filename?, inline? }
    • path must point to an existing readable file
    • content_type and filename override detected values
    • inline: true hints inline rendering for supported images
  • 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 (contains ipc/messages/)
  • PICLAW_CHAT_JID — JID of the chat that triggered this invocation