Bluebubbles

**Quick judgment**: This skill is well-targeted for developers working on the BlueBubbles external channel in Clawdbot. It offers a clear layout, dedicated helper functions, and guidance for webhooks, reactions, and media, making it a strong choice when you need to safely evolve or debug the BlueBubbles plugin rather than hand-rolling integration logic. **What it’s good for** - Editing or extending the BlueBubbles channel implementation (`channel.ts`) and its runtime bridge (`runtime.ts`). - Implementing or improving REST helpers for sending and probing (`send.ts`, `probe.ts`) using centralized REST plumbing (`types.ts`). - Building robust webhook handling in `monitor.ts` with proper sender/chat ID normalization and self-message filtering. - Supporting richer channel features like reactions, typing indicators, read receipts, and inbound attachments using the provided helpers. **Key risks / limitations** - **Scope-limited**: Only useful in the context of the BlueBubbles channel for Clawdbot; not a general messaging abstraction. - **Configuration sensitivity**: Misconfigured `serverUrl`, `password`, or `webhookPath` can lead to delivery failures or security exposure if endpoints are left open or credentials are mishandled. - **Data handling pitfalls**: If you bypass the documented helpers and raw-handle payloads, you risk incorrect ID normalization, mishandled media placeholders, or failing to skip self messages, which can cause loops or broken conversations. **Recommended scenarios** Use this skill when you are: - Maintaining or enhancing the BlueBubbles/iMessage integration for an existing Clawdbot deployment. - Adding capabilities like reactions, rich media, or better health checks to the BlueBubbles channel. - Debugging inbound/outbound issues on the BlueBubbles path and need to align with the established runtime and REST plumbing rather than creating new patterns.