Skills

Agent skills for Photon's SDKs, following the Agent Skills format.

npx skills add photon-hq/skills --skill <skill-name>

---

Skills

Skill	Packages	Description
imessage	@photon-ai/imessage-kit · @photon-ai/advanced-imessage-kit	Send and receive iMessages programmatically. Build AI agents, automations, and conversational apps — self-hosted or on Photon's production infrastructure.
chat-adapter-imessage	chat-adapter-imessage	Connect the Vercel AI SDK to iMessage. Local and remote modes, all adapter methods, and gateway events.
buildspace-ci-cd	photon-hq/buildspace	Configure and troubleshoot BuildSpace reusable GitHub Actions workflows for automated releases across Rust, TypeScript, Go, and Swift.
spectrum	spectrum-ts	Photon's unified messaging SDK for TypeScript. Write your handler once and ship across iMessage, WhatsApp Business, terminal, or a custom platform — plus production architecture patterns.
photon-cli	@photon-ai/cli	The photon CLI (alias pho) — a typed terminal UI for the Photon Dashboard. Authenticate, bootstrap and manage projects, handle billing/upgrades, and manage Spectrum lines, users, and platforms.

---

imessage

npx skills add photon-hq/skills --skill imessage

Two kits, your choice of infrastructure:

• @photon-ai/imessage-kit — Self-hosted. Runs on your Mac.
• @photon-ai/advanced-imessage-kit — Production infrastructure by Photon. Scales to any number of phone numbers.

Covers: sending text, images, files, effects, tapbacks, stickers, and polls · editing and unsending messages · real-time events via WebSockets · group chat management · scheduling and reminders · Find My, FaceTime, and contacts · Photon Webhook for HTTP event forwarding · Photon MCP with 67 tools at mcp.photon.codes · security best practices · error handling and plugins.

chat-adapter-imessage

npx skills add photon-hq/skills --skill chat-adapter-imessage

Adapter that connects the Vercel AI SDK (Chat) to iMessage.

Covers: createiMessageAdapter config for local and remote modes · postMessage, editMessage, deleteMessage, react, startGatewayListener · webhook payload types · feature matrix for Photon server capabilities.

buildspace-ci-cd

npx skills add photon-hq/skills --skill buildspace-ci-cd

Configure and debug BuildSpace-powered release automation using reusable GitHub Actions workflows and blocks.

Covers: workflow selection by project type (Rust, TypeScript, Go, Swift) · required inputs, secrets, and permissions · label-gated release triggers · monorepo handling with topological sorting · cross-platform artifact builds · Homebrew tap and Jamf publishing · README drift detection · dry-run validation · troubleshooting.

spectrum

npx skills add photon-hq/skills --skill spectrum

spectrum-ts is Photon's unified messaging SDK for TypeScript. Write your handler logic once against a single app.messages stream and ship it across iMessage, WhatsApp Business, your terminal, or a custom platform you build yourself.

Covers: installation and the Spectrum() app instance · core primitives (Message, Space, User, Platform provider) · receiving messages and narrowing content (text, attachment, voice, contact, richlink, reaction, poll, group, custom) · the full content builder family · spaces, typing indicators, responding · reactions, tapbacks, and threaded replies · platform narrowing · built-in providers (iMessage cloud/local/dedicated with message effects, Terminal TUI, WhatsApp Business 1:1) · custom event streams and graceful shutdown · authoring custom platforms with definePlatform · production architecture patterns (debounce pipeline, in-flight cancellation, carry-forward, idempotent retries, per-resource memory, job-failure audit log).

photon-cli

npx skills add photon-hq/skills --skill photon-cli

The photon CLI (alias pho) is a typed terminal UI for the Photon Dashboard.

Covers: the device-authorization login flow (login / logout / whoami / auth status) · bootstrapping projects (projects create → id, regenerate-secret for the Spectrum secret, show / list / rename / delete / open) · billing and upgrades (billing plans/show/checkout/manage, projects upgrade to the pro/business/enterprise tiers) · Spectrum resources on a project (spectrum lines/users/platforms/profile/avatar) · config and environment resolution (PHOTON_PROJECT_ID, PHOTON_TOKEN, PHOTON_API_HOST, credentials storage, multi-backend) · end-to-end workflows including free vs. business (dedicated line).

---

Usage

Skills are automatically picked up by supported agents once installed — Cursor, Claude Code, Copilot, OpenCode, and 25+ others.

Try asking your agent:

• Build an iMessage AI agent that auto-replies to group messages
• Send a scheduled message to a contact every morning at 9am
• Connect my Next.js AI chatbot to iMessage using the Vercel AI SDK
• Set up a webhook to receive iMessage events on my server
• Give my Claude agent access to iMessage via MCP
• Send an iMessage using curl from my Python script
• Set up BuildSpace release automation for my TypeScript monorepo
• Build a multi-platform agent with Spectrum that handles iMessage, WhatsApp, and a terminal test harness from one handler
• Design the message-handling pipeline for my Spectrum agent — debouncing bursts, cancellation, idempotent retries
• Log in to Photon, create a project, and tell me its id and secret
• How many Spectrum lines does my project have, and how do I upgrade it to a business line?

---

Ecosystem

Project	Description
Photon Webhook	Forward iMessage events to any HTTP endpoint, signed with HMAC-SHA256 — webhook.photon.codes
Photon MCP	67 MCP tools for iMessage — mcp.photon.codes
HTTP Proxy	RESTful API for iMessage with curl access and Swagger docs — imessage-swagger.photon.codes
Photon	Production iMessage infrastructure — API keys and server URLs

License

MIT