chaos-relay-troubleshoot

Diagnoses and restores CHAOS relay connectivity, configuration, identity, and messaging failures.

3|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/PaulKinlan/pi-chaos-relay --skill chaos-relay-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chaos-relay-troubleshoot
Source: https://github.com/PaulKinlan/pi-chaos-relay/tree/main/skills/chaos-relay-troubleshoot
Command: npx skills add https://github.com/PaulKinlan/pi-chaos-relay --skill chaos-relay-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and recover when the CHAOS relay bridge is broken, misconfigured, or failing to connect, so messaging, replies, and channel pairing can work again.

Core Features & Use Cases

  • Structured Diagnostics: Start with a guided health check to pinpoint whether the issue is config, URL parsing, transport, identity, or relay reachability.
  • Recovery Workflows: Handle common failures like malformed relay URLs, corrupt config files, stale sessions, WebSocket transport problems, and reply-signature errors.
  • Channel Re-Pairing: Recover Telegram, Discord, email, and webhook registrations when pairing codes, verification links, or old sessions no longer work.

Quick Start

Ask the assistant to run /chaos-relay doctor and then follow the first failing check and its suggested fix.

Frequently Asked Questions about chaos-relay-troubleshoot

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

FAQPage Schema
How do I fix a CHAOS relay that is not connecting or sending messages?

Fix CHAOS relay connectivity by running a guided health check to pinpoint config, URL parsing, transport, or reachability failures, then apply recovery workflows like config reset or re-provisioning to restore messaging.

Why are my WebSocket transport or reply-signature requests failing on the relay bridge?

WebSocket transport and reply-signature requests fail due to stale sessions or malformed relay URLs. Diagnose the signed request validation and transport layer, then reset the configuration to restore healthy messaging.

How do I recover broken channel pairing for Telegram, Discord, email, and webhook registrations?

Recover broken channel pairing by re-provisioning Telegram, Discord, email, and webhook registrations when pairing codes, verification links, or old sessions no longer work, validating channel registration after reset.

What is the best way to diagnose a malformed relay URL or corrupt config file?

The best way to diagnose malformed relay URLs or corrupt config files is a doctor-first triage process that validates relay health, checks URL parsing, and applies a config reset to restore connectivity.

How do I reset stale sessions and restore identity for failed relay messaging?

Reset stale sessions and restore identity by re-provisioning the relay configuration, validating signed requests, and checking relay health to ensure messaging and replies work again.