using-imessage-max

using-imessage-max is a skill for Codex from cyberpapiii/imessage-max. It costs 83 tokens per session (1,442 once invoked), scanned A, original, MIT.

Instructions for using an iMessage Max server, a tool that lets an agent inspect and send iMessage conversations. They explain how to find chats, review messages, browse shared items, and choose the right conversation.

In plain words
What is it for?
Catching up on recent or unread conversations, inspecting a known chat, finding active discussions, viewing shared items, and sending messages to the correct thread.
Why use it?
They reduce the risk of missing relevant messages or sending a reply to the wrong thread.

Skill for Codex

Written for Codex: agents/openai.yaml present.

Good fit Catching up on recent or unread conversations, inspecting a known chat, finding active discussions, viewing shared items, and sending messages to the correct thread.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cyberpapiii/imessage-max/using-imessage-max
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add cyberpapiii/imessage-max --skill using-imessage-max
Clone the repo
git clone --depth 1 https://github.com/cyberpapiii/imessage-max

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for using-imessage-max

README.md
[![agentmods](https://agentmods.dev/badge/skills/cyberpapiii/imessage-max/using-imessage-max/github.svg)](https://agentmods.dev/skills/cyberpapiii/imessage-max/using-imessage-max)
Your own site
<a href="https://agentmods.dev/skills/cyberpapiii/imessage-max/using-imessage-max"><img src="https://agentmods.dev/badge/skills/cyberpapiii/imessage-max/using-imessage-max/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for using-imessage-max

Your own site · 80×15
<a href="https://agentmods.dev/skills/cyberpapiii/imessage-max/using-imessage-max"><img src="https://agentmods.dev/badge/skills/cyberpapiii/imessage-max/using-imessage-max.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,442 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00083 $0.01442
Opus 5.5 $0.00033 $0.00577
Sonnet 5.5 $0.00017 $0.00288
Haiku 4.5 $0.00008 $0.00144

Measured 1mo ago against content hash 5afb3f350eb7, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

using-imessage-max scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

using-imessage-max/SKILL.md · 120 lines

How it starts

The opening of the file, as written. The whole thing — 120 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Using iMessage Max

Overview

Use this skill to choose the right iMessage Max tool sequence for the user's intent.

Start broad when completeness matters, then narrow. Unread-only and activity-only views miss things. Do not let either stand in for a full recent overview unless the user asked for that narrower slice.

When reporting results back to the user, use human chat names and participant names. Treat chat_id values such as chat123 as internal handles for follow-up tool calls and exact sends; do not refer to conversations as "Chat 123" in user-facing prose when chat.name, name, or participant labels are available.

Workflow guide

Broad catch-up or daily sweep

Use this when the user says things like:

  • "catch me up on everything I missed"
  • "morning sweep"
  • "what happened in the last day or two"
  • "show me what I should know from my texts"

Default flow:

  1. Start with list_chats using a recent window such as since="1d" or since="2d" and sort="recent".
  2. Use get_unread as a cross-check for still-unread threads and message-level unread review when needed.
  3. Use get_active_conversations only to prioritize which recent threads may deserve attention first.
  4. Use get_messages to drill into the chats surfaced by the overview. If you already hold a next_rowid from a previous turn, call get_messages_since with it instead of get_unread.

Why:

  • list_chats gives the safest broad preview across recent conversations.
  • get_unread is narrower and can miss important chats that were already opened.
  • get_active_conversations is also narrower and can miss quiet but important threads.
  • list_chats, search, get_unread, and find_chat hide junk and unknown-sender chats by default and report how many in filtered_hidden. Only pass include_filtered=true when the user asks about a message that did not show up.

Targeted lookup

Use this when the user already knows the person, thread, or topic.

  • If they know the person or chat identity, start with find_chat.
  • If they already know the exact thread, use get_chat_details before opening message history.
  • If they know the topic but not the chat, start with search.
  • Then use get_messages or get_context to read the relevant section in detail.

Read the full file on GitHub · 120 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +5 lines 5afb3f350eb7
  2. 2mo ago First seen · 115 lines · 83 tokens per session scan A 15ca9bb71a55

Subscribe to this mod's changes

using-imessage-max is a skill published in the GitHub repository cyberpapiii/imessage-max (6 stars, last pushed yesterday), licensed MIT. It adds 83 tokens to every session and 1,442 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

orbit-notion

Open Orbit briefing skill — selected by the Orbit pipeline when Notion is the user's only connected connector, or when the user explicitly scopes their daily digest to Notion. Pulls the past 24 hours of document edits, comments, mentions, and database row changes from the user's authenticated Notion connection and…

nexu-io/open-design · 117 tokens

agentmail

Use your assigned AgentMail inbox to read email tasks, explicitly send or reply, and check delivery. Provided automatically by your inbox assignment.

paperclipai/paperclip · 30 tokens

Cortex

LifeOS memory, prior-session recall, and learning capture. USE WHEN capture this learning, document this learning, what did we learn recently, recent learnings, cortex, knowledge, knowledge base, search knowledge, what do we know about, archive, harvest, knowledge status, develop note, add to knowledge, add a people…

danielmiessler/LifeOS · 184 tokens

rowboat-spaces

How to work as a member of Rowboat Spaces, the team chat where people and agents work together. Load it once per session, before acting on any request that reaches you from Rowboat; it covers your setup, mentions and hand-offs, the tools, and files.

rowboatlabs/rowboat · 60 tokens

feishu

Work with Feishu or Lark bots, docs, sheets, bitables, approval flows, and OpenAPI/MCP setup without hardcoding credentials.

Hmbown/CodeWhale · 33 tokens

pinchtab-mcp

Use this skill when a task requires browser automation through PinchTab's MCP server connected to a remote browser instance. Covers navigation, element interaction, data extraction, form filling, multi-step flows, and session management via MCP tools.

pinchtab/pinchtab · 52 tokens