vm-debug

What problem does it solve?

This Skill helps you investigate and troubleshoot the live werewolf-simple game running on the production VM without guessing, by gathering the evidence needed from logs, containers, and the database.

Core Features & Use Cases

• Service Health Checks: Verify backend availability and container status on the running stack.
• Log Inspection: Review backend logs, frontend/Nginx logs, and recent error output to trace failures.
• Database Forensics: Run safe Postgres queries to inspect rooms, games, players, and event history.
• Remote Debug Script Execution: Execute the repository's debugging scripts against the VM backend for deterministic checks.
• Production Safety Guidance: Follow guardrails that prevent destructive actions on the live environment.

Quick Start

Use this skill to inspect the production VM for a specific bug by checking health, reviewing the relevant logs, and querying the database read-only before making any code changes.