How do I install the Org Imessage skill?

Run npx skillmds@latest add pooriaarab/org-imessage in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Org Imessage safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Org Imessage?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Org Imessage free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Org Imessage?

pooriaarab (@pooriaarab) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Org Imessage by pooriaarab — Agent Skill

Name: Org Imessage
Author: pooriaarab

Org Imessage

Use when the user wants to clean up iMessage / Messages.app on macOS — archiving stale conversations, identifying unread-but-irrelevant threads, exporting important conversations, and reducing clutter. Triggers: 'organize Messages', 'my Messages is overwhelming'.

pooriaarab c988d56 2.2 KB Updated Sep 17, 2026

File contents

iMessage Organizer

Clean up Messages.app on macOS.

Requirements

macOS Messages.app with iCloud Messages enabled.
imsg CLI — brew install steipete/tap/imsg (repo). Read iMessage history via SQLite, send messages, manage conversations.
Full Disk Access for the terminal so imsg can read ~/Library/Messages/chat.db.
AppleScript automation for some actions where imsg doesn't cover the action.

Step 1 — Ask the User First

1. Scope — all conversations, or filter by date (e.g. "last 6 months only")?
2. Conversation classification — keep / archive / mute / delete?
3. Group chats — same treatment, or separate rules?
4. Attachment cleanup — purge old large attachments to free disk?
5. Aggressiveness — dry-run / archive-only / archive + delete-old-spam (verification codes, OTPs).

Steps (TBD)

Inventory — read chat.db (read-only) for conversation list, last-message-date, message counts.
Classify — active (msg in last 30 days) / dormant / spam (one-shot OTP senders).
Plan — proposed archive/mute/delete list.
Approve — batch by category.
Apply — Messages.app supports limited bulk operations via AppleScript; some actions (delete conversation) are manual.
Verify — final state check.

Surface-specific notes

Bulk delete of conversations isn't well-supported via AppleScript — many actions require manual UI driving (or cliclick).
iMessage attachments live in ~/Library/Messages/Attachments/ and can hog disk — separate cleanup target.
iCloud Messages: actions sync to all devices.

---name: org-imessagedescription: Use when the user wants to clean up iMessage / Messages.app on macOS — archiving stale conversations, identifying unread-but-irrelevant threads, exporting important conversations, and reducing clutter. Triggers: 'organize Messages', 'my Messages is overwhelming'.---# iMessage OrganizerClean up Messages.app on macOS.## Requirements- macOS Messages.app with iCloud Messages enabled.- **`imsg` CLI** — `brew install steipete/tap/imsg` ([repo](https://github.com/steipete/imsg)). Read iMessage history via SQLite, send messages, manage conversations.- Full Disk Access for the terminal so `imsg` can read `~/Library/Messages/chat.db`.- AppleScript automation for some actions where `imsg` doesn't cover the action.## Step 1 — Ask the User First```1. Scope — all conversations, or filter by date (e.g. "last 6 months only")?2. Conversation classification — keep / archive / mute / delete?3. Group chats — same treatment, or separate rules?4. Attachment cleanup — purge old large attachments to free disk?5. Aggressiveness — dry-run / archive-only / archive + delete-old-spam (verification codes, OTPs).```## Steps (TBD)1. **Inventory** — read `chat.db` (read-only) for conversation list, last-message-date, message counts.2. **Classify** — active (msg in last 30 days) / dormant / spam (one-shot OTP senders).3. **Plan** — proposed archive/mute/delete list.4. **Approve** — batch by category.5. **Apply** — Messages.app supports limited bulk operations via AppleScript; some actions (delete conversation) are manual.6. **Verify** — final state check.## Surface-specific notes- Bulk delete of conversations isn't well-supported via AppleScript — many actions require manual UI driving (or `cliclick`).- iMessage attachments live in `~/Library/Messages/Attachments/` and can hog disk — separate cleanup target.- iCloud Messages: actions sync to all devices.## See also- [`../org-life-organizer/_lib/taxonomy.md`](../org-life-organizer/_lib/taxonomy.md)- [`../org-life-organizer/_lib/patterns.md`](../org-life-organizer/_lib/patterns.md)- [`../mac-organizer/SKILL.md`](../mac-organizer/SKILL.md) — for attachment disk cleanup

Frequently asked questions