vm-debug

Diagnose production VM issues via logs, Postgres queries, and container health checks.

Updated Jun 25, 2025
One-click install
npx skills add https://github.com/wangdaqian08/werewolf-simple --skill vm-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vm-debug
Source: https://github.com/wangdaqian08/werewolf-simple/tree/main/.claude/skills/vm-debug
Command: npx skills add https://github.com/wangdaqian08/werewolf-simple --skill vm-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about vm-debug

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

FAQPage Schema
How do I troubleshoot live production VM issues in Docker Compose?

To troubleshoot live production VM issues, you perform service health checks, inspect backend and Nginx logs, run safe Postgres forensics, and execute remote debugging scripts to gather evidence without guessing.

What is the safest way to inspect Postgres data during production troubleshooting?

The safest way to inspect Postgres data during production troubleshooting is using read-only investigation practices, querying rooms, games, players, and event history without executing destructive actions on the live environment.

How do I check container health and backend availability on a production VM?

You check container health and backend availability on a production VM by verifying the running stack's status through Docker Compose with the production env file and reviewing recent error output.

Do I need gcloud authentication to debug a remote VM backend?

Yes, you need gcloud authentication and VM SSH access through the repo helper to debug a remote VM backend, allowing you to execute deterministic debugging scripts against the live environment.

Why review Nginx logs when debugging a live production VM?

Reviewing Nginx logs during live production VM debugging helps trace frontend failures by inspecting web server error output and request history alongside backend application logs to locate the root cause.

What are the limitations when running remote debugging scripts on a production VM?

The main limitation when running remote debugging scripts is adhering to production safety guidance; you must follow read-only investigation practices and avoid destructive actions to prevent impacting the live environment.