debug

Debug full-stack apps via 5 Whys, Vitest, Biome, and agent-browser.

1|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/GrupoUS/gpus --skill debug-grupous
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/GrupoUS/gpus/tree/main/.kilocode/skills/debug
Command: npx skills add https://github.com/GrupoUS/gpus --skill debug-grupous

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a unified approach to identifying, diagnosing, and resolving bugs across backend, database, and frontend applications, streamlining the development and maintenance process.

Core Features & Use Cases

  • Systematic Debugging: Employs a 4-phase process (Reproduce, Isolate, Understand, Fix) and the 5 Whys technique for root cause analysis.
  • Automated Testing: Integrates with biome for linting/type checking and vitest for unit and integration tests.
  • Frontend Interaction: Utilizes agent-browser for visual debugging, element interaction, and end-to-end testing.
  • Database Analysis: Leverages Neon MCP tools for identifying slow queries and executing SQL.
  • Deployment Checks: Provides commands to inspect Railway deployment logs for errors.
  • Use Case: When a user reports a bug in the application, this Skill can systematically guide you through reproducing the issue, pinpointing the faulty code, understanding the root cause using the 5 Whys, and verifying the fix with automated tests and browser checks.

Quick Start

Use the debug skill to run backend checks and tests for the current project.

Frequently Asked Questions about debug

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

FAQPage Schema
What is the best way to debug full-stack application errors across backend and frontend?

Systematic debugging involves a 4-phase process: Reproduce, Isolate, Understand, and Fix. After reproducing the bug, you isolate the faulty code, perform root cause analysis using the 5 Whys technique, and verify the fix through automated testing.

How do I find the root cause of a database bug using SQL analysis?

To find the root cause of a database bug, leverage Neon MCP tools to identify slow queries and execute SQL. This isolates problematic database operations and pinpoints performance bottlenecks or faulty data logic within your application.

Can I use Vitest and Biome for automated verification when fixing code errors?

Yes, you can use Vitest and Biome for automated testing when fixing code errors. Vitest executes unit and integration tests, while Biome performs linting and type checking to verify that your code fixes are valid and structurally sound.

Does this debugging framework work with Railway deployment logs and agent-browser for end-to-end testing?

Yes, this debugging framework works with Railway deployment logs and agent-browser. It provides commands to inspect Railway logs for deployment errors and utilizes agent-browser for visual debugging, element interaction, and end-to-end frontend testing.

How do I systematically reproduce and isolate a reported bug in my application?

To systematically reproduce and isolate a reported bug, follow a structured debugging process to recreate the exact issue, then narrow down the specific faulty code area. This isolation step is critical before performing root cause analysis with the 5 Whys technique.

What are the limitations of using the 5 Whys technique for root cause analysis in software engineering?

The 5 Whys technique for root cause analysis is limited by the investigator's domain knowledge and may stop prematurely at a symptom. It is most effective when combined with automated testing and database query analysis to empirically verify the identified root cause.