imsg SKILL.md skillA

imsg from openclaw/nix-openclaw-tools is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add openclaw/nix-openclaw-tools/imsg@git:20260908.d24bc3c

Pins git:20260908.d24bc3c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
openclaw/nix-openclaw-tools
Path
tools/imsg/skills/imsg/SKILL.md
Versions recorded
5
Latest version
git:20260908.d24bc3c, committed Sep 8, 2026
First version recorded
Feb 18, 2026
Size
10,851 bytes
Repository stars
54
License
MIT

Use the imsg CLI from OpenClaw agents for iMessage/SMS DMs, groups, replies, reactions, polls, watching, and private-API actions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# imsg

Use the generic `message` tool first for actions that its current iMessage schema exposes. Use `imsg` when the task needs local Messages.app history, target discovery, watching, or an administrative/private-API capability that is not exposed by `message`.

Do not use this skill for Telegram, Signal, WhatsApp, Discord, Slack, or for replying inside the current OpenClaw conversation when the configured channel already routes the reply.

## Agent Flow

1. Resolve the conversation first.
2. Choose DM, existing group, or new group.
3. Prefer an available `message` action; otherwise pick the lowest-capability `imsg` command that preserves the requested semantics.
4. Confirm any send or visible state change unless the user already gave exact recipient, content, and action.
5. Execute with stable identifiers: prefer `--chat-id` for normal sends/watch/history and `--chat` chat GUID for bridge actions.

Never infer a recipient from a casual name alone when several chats or handles could match. Show the matched display name, handle(s), group participants, and message text/action before sending.

## Host Requirements
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add openclaw/nix-openclaw-tools/imsg@sha256:34c4d895d8557e85

The line at the top of this page pins the label git:20260908.d24bc3c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_77eyfo3dkvpdhgoa.svg)](https://markdownregistry.com/a/art_77eyfo3dkvpdhgoa)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Feb 18, 2026 and Sep 8, 2026, about one every 51 days.

versioncommittedcommitsizeaudit
git:20260908.d24bc3c latest2026-09-08 d24bc3c 10,851 BA view · diff
git:20260705.e2f62ff2026-07-05 e2f62ff 10,091 BA view · diff
git:20260517.9085cb52026-05-17 9085cb5 2,923 BA view · diff
git:20260315.cd4c4292026-03-15 cd4c429 2,976 BA view · diff
git:20260218.d5fc8e22026-02-18 d5fc8e2 2,976 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10851 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

openclaw/nix-openclaw-tools · 54 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_77eyfo3dkvpdhgoa
GET https://markdownregistry.com/api/v1/resolve?ref=openclaw/nix-openclaw-tools/imsg
GET https://markdownregistry.com/api/v1/blob/34c4d895d8557e85e9be08f792bbafe9be5e3b5cc385aaba1db99ea5acdbef26

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from openclaw/nix-openclaw-tools

AGENTS.md AGENTS.md file
openclaw/nix-openclaw-tools · AGENTS.md
git:20260506.1732fb7 · audit A · 54 stars
camsnap SKILL.md skill
openclaw/nix-openclaw-tools · tools/camsnap/skills/camsnap/SKILL.md · Capture frames or clips from RTSP/ONVIF cameras and local webcams, including USB pan/tilt/zoom control.
git:20260824.cc4a48f · audit A · 54 stars
discrawl SKILL.md skill
openclaw/nix-openclaw-tools · tools/discrawl/skills/discrawl/SKILL.md · Discord archive: search, sync freshness, DMs, summaries, TUI, repo/release work.
git:20260913.41dd696 · audit A · 54 stars
gog SKILL.md skill
openclaw/nix-openclaw-tools · tools/gogcli/skills/gog/SKILL.md · Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
git:20260924.59d7316 · audit A · 54 stars
goplaces SKILL.md skill
openclaw/nix-openclaw-tools · tools/goplaces/skills/goplaces/SKILL.md · Query Google Places for text search, place details, resolve, reviews, or scriptable JSON via goplaces.
git:20260908.d24bc3c · audit A · 54 stars
peekaboo SKILL.md skill
openclaw/nix-openclaw-tools · tools/peekaboo/skills/peekaboo/SKILL.md · Capture and automate macOS UI with the Peekaboo CLI.
git:20261012.ebe513a · audit A · 54 stars
poltergeist SKILL.md skill
openclaw/nix-openclaw-tools · tools/poltergeist/skills/poltergeist/SKILL.md · File watcher with auto-rebuild for any language or build system.
git:20260104.d5df36f · audit A · 54 stars
qmd SKILL.md skill
openclaw/nix-openclaw-tools · tools/qmd/skills/qmd/SKILL.md · Search markdown knowledge bases, notes, and documentation using QMD. Use when users ask to search notes, find…
v2.0.0 · audit A · 54 stars
sag SKILL.md skill
openclaw/nix-openclaw-tools · tools/sag/skills/sag/SKILL.md · ElevenLabs text-to-speech with mac-style say UX.
git:20260914.d3819bd · audit A · 54 stars
sonoscli SKILL.md skill
openclaw/nix-openclaw-tools · tools/sonoscli/skills/sonoscli/SKILL.md · Control Sonos speakers (discover/status/play/volume/group).
git:20260517.9085cb5 · audit A · 54 stars
summarize SKILL.md skill
openclaw/nix-openclaw-tools · tools/summarize/skills/summarize/SKILL.md · Summarize or transcribe URLs, YouTube/videos, podcasts, articles, transcripts, PDFs, and local files.
git:20260517.9085cb5 · audit A · 54 stars
wacli SKILL.md skill
openclaw/nix-openclaw-tools · tools/wacli/skills/wacli/SKILL.md · Send third-party WhatsApp messages or sync/search WhatsApp history via wacli, not normal active chats.
git:20261007.5614971 · audit A · 54 stars

Every file in openclaw/nix-openclaw-tools

Other files named imsg

imsg SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
git:20260328.33f9833 · audit A · 2,480 stars
imsg SKILL.md skill
trpc-group/trpc-agent-go · openclaw/skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
git:20260304.8ebbeae · audit A · 1,890 stars
imsg SKILL.md skill
cowork-os/cowork-os · resources/skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
v1.0.0 · audit A · 517 stars
imsg SKILL.md skill
letta-ai/skills · tools/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
git:20260422.d32735f · audit A · 153 stars
imsg SKILL.md skill
metaspartan/cybara · skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
git:20260218.a87179d · audit A · 33 stars
imsg SKILL.md skill
pr-e/openclaw-master-skills · skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
git:20260311.3e83cee · audit A · 3 stars

Browse by kind, by grade A, or by owner.