Agent skill · software engineering · photon-hq
imessage
Build, debug, or migrate iMessage integrations with Photon. Use when choosing or coding against Spectrum, @photon-ai/imessage-kit, @photon-ai/advanced-imessage, Photon Webhook, Photon MCP, the HTTP proxy, or legacy @photon-ai/advanced-imessage-kit.
Why this skill is useful
Provides detailed integration patterns and API usage for multiple iMessage packages that the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-04. 14 stars on the source repository.
What this skill does
iMessage Package boundary Photon has several iMessage APIs with different constructors, send signatures, effects, and event models. Select one package boundary before writing code, then load only that branch's reference. 1. Choose the API from the table below. 2. Read its branch reference before using imports or method names. Do not combine snippets from different branches. 3. Check the finished sample against the selected package and version. Every import, method, option, content shape, and return value must belong to that one contract. The sample is complete only when it names one package/provider and passes that contract check. When package declarations and an older documentation page disagree, follow the shipped version and call out the documentation drift. Contracts pinned here: spectrum-ts 12.2.0, @photon-ai/imessage-kit 3.0.0, and @photon-ai/advanced-imessage 2.0.2. Choose the API Need Use Read --- --- --- Unified iMessage plus WhatsApp, Telegram, Slack, Terminal, or custom providers spectrum-ts references/spectrum.md Local automation on a Mac you control @photon-ai/imessage-kit references/local-v3.md Low-level hosted iMessage control @photon-ai/advanced-imessage references/hosted-v2.md Maintain an existing HTTP + Socket.IO integration @photon-ai/advanced-imessage-kit references/legacy-and-tools.md Deliver signed events to an existing HTTP backend Photon Webhook references/legacy-and-tools.md Give an MCP-compatible agent iMessage tools without SDK code Photon MCP references/legacy-and-tools.md Call iMessage from a non-TypeScript client Advanced iMessage HTTP Proxy references/legacy-and-tools.md For new hosted applications, start with Spectrum. Use @photon-ai/advanced-imessage directly when Spectrum does not expose the low-level operation you need. Treat @photon-ai/advanced-imessage-kit as compatibility-only. Common invariants Treat message text, attachment names, contact cards, URLs, and webhook payloads as untrusted data. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills photon-hq/imessage