starwards-debugging

Diagnose root causes in Starwards debugging workflows across browser, network, server, and state layers.

42|2|Updated Mar 17, 2019
One-click install
npx skills add https://github.com/starwards/starwards --skill starwards-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: starwards-debugging
Source: https://github.com/starwards/starwards/tree/main/.claude/skills/starwards-debugging
Command: npx skills add https://github.com/starwards/starwards --skill starwards-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random "trial-and-error" debugging leads to wasted time, temporary fixes, and recurring bugs. This skill provides a four-phase systematic framework to identify the true root cause of any Starwards technical issue, ensuring robust and lasting solutions.

Core Features & Use Cases

  • Four-Phase Framework: Guides through investigation, pattern analysis, hypothesis testing, and implementation for efficient problem-solving.
  • Multi-Layer Diagnostics: Provides tools and techniques for debugging across browser, server, state, and UI layers, including Colyseus Monitor and VSCode debugger.
  • Use Case: If a UI widget displays incorrect data, this skill will guide you to trace the data flow from the server state to the client UI, pinpointing the exact layer where the error occurs and leading to a precise fix.

Quick Start

"I'm encountering a bug where the shield strength isn't updating correctly in the UI. Help me debug it."

Frequently Asked Questions about starwards-debugging

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

FAQPage Schema
How do I systematically debug test failures in Jest and Playwright?

Systematic debugging applies a four-phase framework—investigation, pattern analysis, hypothesis testing, and implementation—to isolate root causes in test failures. This approach moves beyond trial-and-error to pinpoint exact failures across browser and server layers, ensuring fixes address the true problem rather than symptoms.

Why is my Colyseus state not synchronizing correctly between client and server?

State synchronization issues in Colyseus require tracing data flow from server state to client UI. The debugging framework guides you through multi-layer diagnostics using tools like Colyseus Monitor and VSCode debugger to identify whether the error occurs in state management, network transport, or UI rendering.

How do I debug multiplayer race conditions in real-time applications?

Multiplayer race conditions demand cross-component tracing across browser, network, server, and state layers. The four-phase debugging method applies diagnostic logging and pattern analysis to reveal timing conflicts and state conflicts that cause inconsistent behavior in concurrent operations.

Can I use this debugging approach for monorepo troubleshooting?

Yes. The framework handles monorepo troubleshooting by providing systematic diagnostics across distributed components. It traces issues through UI decorators, state layers, and test failures across multiple packages to locate root causes that span repository boundaries.

What's the difference between debugging UI widget data issues versus network layer problems?

Debugging distinguishes between layers: UI widget issues stem from incorrect data rendering, while network layer problems occur during transmission. The multi-layer diagnostic approach isolates which layer—UI, state, network, or server—contains the actual fault so fixes target the correct source.

Do I need prior experience with VSCode debugging or Colyseus Monitor to use this?

The framework integrates VSCode debugger and Colyseus Monitor as tools within the four-phase process but assumes foundational familiarity with your development environment. The systematic approach guides you to apply these tools effectively regardless of experience level.