{
  "markdown": "# Skills\n\n[![skills.sh](https://img.shields.io/badge/skills.sh-photon--hq%2Fskills-blue)](https://skills.sh/photon-hq/skills)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/photon-hq/skills)](https://github.com/photon-hq/skills)\n\nAgent skills for [Photon](https://photon.codes/spectrum)'s SDKs, following the [Agent Skills](https://skills.sh/) format.\n\n```bash\nnpx skills add photon-hq/skills --skill <skill-name>\n```\n\n---\n\n## Skills\n\n| Skill | Packages | Description |\n| :--- | :--- | :--- |\n| [`imessage`](./skills/imessage/SKILL.md) | `@photon-ai/imessage-kit` · `@photon-ai/advanced-imessage` · `spectrum-ts` | Send and receive iMessages programmatically with the current local, hosted, or unified SDK. |\n| [`chat-adapter-imessage`](./skills/chat-adapter-imessage/SKILL.md) | `chat-adapter-imessage` | Connect the [Vercel AI SDK](https://sdk.vercel.ai) to iMessage. Local and remote modes, all adapter methods, and gateway events. |\n| [`buildspace-ci-cd`](./skills/buildspace-ci-cd/SKILL.md) | `photon-hq/buildspace` | Configure and troubleshoot BuildSpace reusable GitHub Actions workflows for automated releases across Rust, TypeScript, Go, and Swift. |\n| [`spectrum`](./skills/spectrum/SKILL.md) | `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. |\n| [`photon-cli`](./skills/photon-cli/SKILL.md) | `@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. |\n\n---\n\n### imessage\n\n```bash\nnpx skills add photon-hq/skills --skill imessage\n```\n\nChoose the API that matches the infrastructure:\n\n- **[`@photon-ai/imessage-kit`](https://github.com/photon-hq/imessage-kit)** — Self-hosted. Runs on your Mac.\n- **[`@photon-ai/advanced-imessage`](https://www.npmjs.com/package/@photon-ai/advanced-imessage)** — Current low-level hosted SDK with HTTP and gRPC transports.\n- **[`spectrum-ts`](https://photon.codes/docs/spectrum-ts/getting-started)** — Recommended unified API for most new messaging apps.\n\n**Covers:** the v3 local SDK object API · current hosted HTTP/gRPC entrypoints · text, attachments, effects, reactions, edits, unsends, chats, and groups · live gRPC events and HTTP webhooks · [Photon MCP](https://github.com/photon-hq/mcp) · security, retries, error handling, and local plugins. The old `@photon-ai/advanced-imessage-kit` API is documented only as legacy compatibility guidance.\n\n### chat-adapter-imessage\n\n```bash\nnpx skills add photon-hq/skills --skill chat-adapter-imessage\n```\n\nAdapter that connects the [Vercel AI SDK (Chat)](https://sdk.vercel.ai) to iMessage.\n\n**Covers:** `createiMessageAdapter` config for local and remote modes · `postMessage`, `editMessage`, `deleteMessage`, `react`, `startGatewayListener` · webhook payload types · feature matrix for Photon server capabilities.\n\n### buildspace-ci-cd\n\n```bash\nnpx skills add photon-hq/skills --skill buildspace-ci-cd\n```\n\nConfigure and debug [BuildSpace](https://github.com/photon-hq/buildspace)-powered release automation using reusable GitHub Actions workflows and blocks.\n\n**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.\n\n### spectrum\n\n```bash\nnpx skills add photon-hq/skills --skill spectrum\n```\n\n[`spectrum-ts`](https://github.com/photon-hq/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.\n\n**Covers:** installation and the `Spectrum()` app instance · core primitives (Message, Space, User, Platform provider) · receiving messages and narrowing content (text, markdown, attachment, voice, contact, richlink, app, reaction, poll, group, custom) · core content builders · spaces, typing indicators, `responding` · reactions, tapbacks, and threaded replies · platform narrowing · built-in providers (separate iMessage cloud/local providers with shared/dedicated cloud line models and 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).\n\n### photon-cli\n\n```bash\nnpx skills add photon-hq/skills --skill photon-cli\n```\n\nThe [`photon`](https://www.npmjs.com/package/@photon-ai/cli) CLI (alias `pho`) is a typed terminal UI for the [Photon Dashboard](https://app.photon.codes/).\n\n**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).\n\n---\n\n## Usage\n\nSkills are automatically picked up by supported agents once installed — Cursor, Claude Code, Copilot, OpenCode, and [25+ others](https://skills.sh/).\n\n**Try asking your agent:**\n\n- *Build an iMessage AI agent that auto-replies to group messages*\n- *Send a scheduled message to a contact every morning at 9am*\n- *Connect my Next.js AI chatbot to iMessage using the Vercel AI SDK*\n- *Set up a webhook to receive iMessage events on my server*\n- *Give my Claude agent access to iMessage via MCP*\n- *Send an iMessage using curl from my Python script*\n- *Set up BuildSpace release automation for my TypeScript monorepo*\n- *Build a multi-platform agent with Spectrum that handles iMessage, WhatsApp, and a terminal test harness from one handler*\n- *Design the message-handling pipeline for my Spectrum agent — debouncing bursts, cancellation, idempotent retries*\n- *Log in to Photon, create a project, and tell me its id and secret*\n- *How many Spectrum lines does my project have, and how do I upgrade it to a business line?*\n\n---\n\n## Ecosystem\n\n| Project | Description |\n| :--- | :--- |\n| [Photon Webhook](https://github.com/photon-hq/webhook) | Forward iMessage events to any HTTP endpoint, signed with HMAC-SHA256 — [webhook.photon.codes](https://webhook.photon.codes/) |\n| [Photon MCP](https://github.com/photon-hq/mcp) | 67 MCP tools for iMessage — [mcp.photon.codes](https://mcp.photon.codes) |\n| [HTTP Proxy](https://github.com/photon-hq/advanced-imessage-http-proxy) | RESTful API for iMessage with curl access and Swagger docs — [imessage-swagger.photon.codes](https://imessage-swagger.photon.codes/swagger) |\n| [Photon](https://photon.codes/spectrum) | Production iMessage infrastructure — API keys and server URLs |\n\n## License\n\nMIT\n",
  "bytes": 7478,
  "sha": "e58d17b92c9b3d4951891808cf85aa70e6965553f9b27d146a6c181fc4ee7831",
  "repo_slug": "photon-hq/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_photon_hq_skills_spectrum_8b615219/readme"
}