gsd-debug

Diagnose software issues and produce structured root-cause analyses.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-debug
Source: https://github.com/optivent/gsd-kimi-cli/tree/main/skills/gsd-debug
Command: npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging software issues and generating structured root-cause analyses to guide fixes.

Core Features & Use Cases

  • Systematic debugging: apply root-cause analysis to identify underlying issues.
  • Debug session generation: create and manage a dedicated debug session file with context and observations.
  • Fix planning: produce actionable repair plans and optional FIX-PLAN.md for complex problems.
  • Orchestrated tooling: coordinates with the gsd-debugger subagent to test hypotheses and validate fixes.

Quick Start

Describe the issue in detail to initiate a debugging session and let GSD compute a root-cause and fix plan.

Frequently Asked Questions about gsd-debug

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

FAQPage Schema
How do I perform root-cause analysis for software issues across a codebase?

Root-cause analysis for software issues is performed by generating a dedicated debug session that records context and observations to systematically identify underlying problems. This Skill orchestrates debugging by coordinating with a subagent to test hypotheses and validate fixes.

What's the best way to create an actionable fix plan for complex debugging problems?

Creating an actionable fix plan for complex debugging problems involves producing structured repair documentation from your root-cause analysis. This Skill can generate an optional FIX-PLAN.md file alongside debug session notes to guide systematic resolution.

Can I use this to debug CI pipelines and deployment environments, or is it only for local codebases?

Debugging CI pipelines and deployment environments is fully supported alongside local codebase troubleshooting. This Skill applies systematic root-cause analysis across all software environments to diagnose issues and produce structured fix plans.

How do I start a debugging session when I encounter an unexpected software issue?

Starting a debugging session requires describing the software issue in detail to initiate the process. This Skill then computes a root-cause analysis and generates an actionable fix plan, creating a debug session file to track observations and context.

Why does my software issue need a structured debug session instead of just reading error logs?

A structured debug session is needed because it systematically records context and observations to guide root-cause identification, rather than relying on manual log inspection. This approach validates hypotheses through orchestrated tooling to produce reliable fix plans.