skills.rest
PaulKinlan
PaulKinlanCOMMUNITY
Explore all skills by this author →
Website𝕏@paul_kinlanGitHub

chaos-relay

Connect the pi agent to a CHAOS relay for Telegram, Discord, email, and webhook messaging.

3|Updated Jun 21, 2026
Search Tags:#email#discord#webhooks#telegram#agent inbox#message relay#chaos relay
One-click install
npx skills add https://github.com/PaulKinlan/pi-chaos-relay --skill chaos-relay
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chaos-relay
Source: https://github.com/PaulKinlan/pi-chaos-relay/tree/main/skills/chaos-relay
Command: npx skills add https://github.com/PaulKinlan/pi-chaos-relay --skill chaos-relay

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects the pi agent to external communication channels so users can talk to their agent from Telegram, Discord, email, or webhooks and receive replies back in the original thread.

Core Features & Use Cases

  • Channel setup and linking: Register Telegram bots, Discord bots, email addresses, and inbound webhooks through the CHAOS relay.
  • Inbound message handling: Receive new messages automatically through WebSocket push with polling fallback, including attachment handling for supported channels.
  • Threaded replies and approvals: Reply to the originating channel thread and optionally gate risky actions with approval modes.
  • Use Case: A user sends a request to a Telegram bot, the agent reads it inside pi, and the reply is posted back to that same conversation.

Quick Start

Set up the CHAOS relay connection, register your preferred channel, and then send a message from that channel so the agent can receive and reply to it.

Frequently Asked Questions about chaos-relay

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect my AI agent to Telegram and Discord so it can reply in chat threads?▼

You can connect your agent to Telegram and Discord by registering your bots through a message relay. The relay provisions sessions, handles inbound message polling or WebSocket push delivery, and posts replies back to the original conversational thread.

Can I receive emails and process inbound webhooks using an agent inbox?▼

Yes, a message relay can link your email addresses and inbound webhooks to your agent. It provisions channels, requires signed relay authentication for security, and supports attachment handling for incoming messages across these formats.

What is a message relay for connecting external chat channels to an AI agent?▼

A message relay is a bridge that connects external communication channels like email and chat apps to your agent. It manages channel registration, session provisioning, and two-way message delivery, allowing external users to interact with the agent seamlessly.

How do I set up channel pairing and authentication for a chat agent relay?▼

Setting up channel pairing involves registering your specific channel, such as a Telegram bot, and completing channel-specific verification. The process requires signed relay authentication and persistent local credentials to enable secure two-way communication.

Does the agent inbox relay support message polling fallback when WebSocket push fails?▼

Yes, the relay supports automatic message delivery through WebSocket push with a polling fallback. This ensures inbound messages from registered channels are still received and processed even if the persistent push connection drops.

Can I gate risky agent actions behind approval modes when replying to external messages?▼

Yes, the relay supports threaded replies to originating channels and can optionally gate risky actions with approval modes. This provides a safety layer for external conversational workflows initiated from chat or email.

Related Skills

Explore More Software Engineering Skills→
broomvabroomva
3

claude-code-channels

Integrate Telegram and Discord bots with Claude Code via MCP server plugins.

Community
Advanced
JansenAnalyticsJansenAnalytics
5

bluebubbles

Route and control iMessages through BlueBubbles with send, react, edit, unsend, and reply actions.

Community
Intermediate
2025Emma2025Emma
22.7k

telegram-dev

Build Telegram bots, Mini Apps, and clients using Bot API and TDLib.

Community
Intermediate
MikeyMiamiMikeyMiami
1

textgrid-provider

Configure TextGrid outbound SMS, inbound webhooks, and A2P 10DLC registration.

Community
Advanced