troubleshoot

Diagnose SignalRoom health issues using read-only diagnostics and log extraction.

Updated Dec 19, 2025
One-click install
npx skills add https://github.com/mmbianco78/signalroom --skill troubleshoot-mmbianco78
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/mmbianco78/signalroom/tree/main/.claude/skills/troubleshoot
Command: npx skills add https://github.com/mmbianco78/signalroom --skill troubleshoot-mmbianco78

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides read-only diagnostics and troubleshooting procedures to quickly identify and resolve system issues without making accidental changes.

Core Features & Use Cases

  • System Health Checks: Quickly verify database connections, worker status, and pipeline health.
  • Use Case: When you need to check why the Temporal worker isn't processing activities, this Skill gives you the exact commands to diagnose the problem.

Quick Start

Use the troubleshoot skill to check the current status of the Fly.io worker and recent pipeline runs.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I diagnose why my SignalRoom worker isn't processing activities?

Diagnose worker issues using read-only health checks that verify Temporal worker status, recent pipeline runs, and database connectivity without making changes. The troubleshoot Skill provides exact commands to identify failures and confirm configurations.

What's the best way to check SignalRoom system health quickly?

System health checks verify database connections, worker status, and pipeline health using read-only diagnostics. This approach identifies problems fast during debugging without risking accidental mutations to your system.

How do I analyze logs and verify connectivity in SignalRoom?

Log analysis and connectivity verification extract diagnostics from system logs and test connections using allowed read-only tools. This identifies configuration issues and connectivity failures while keeping your system unchanged.

Can I troubleshoot SignalRoom issues without modifying the system?

Yes. Read-only diagnostics let you troubleshoot using Grep, Glob, Bash, and Read tools to produce non-mutating insights, extract logs, and verify status without accidental changes.

What information do I need before running diagnostics on SignalRoom?

Diagnostics require restricted-write access and work with logs, connection details, and worker configuration data already present in your environment. No additional setup is required beyond access permissions.