guided-debugging

Guide learners through structured debugging with Socratic questioning and phased workflows.

6|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/ricardogomes/learning-skills --skill guided-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guided-debugging
Source: https://github.com/ricardogomes/learning-skills/tree/main/skills/guided-debugging
Command: npx skills add https://github.com/ricardogomes/learning-skills --skill guided-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides learners through structured debugging thinking to improve problem-solving performance.

Core Features & Use Cases

  • Socratic, question-based prompts that steer learners through eight phased debugging workflows.
  • Gate-driven progression requiring substantive learner input at every stage.
  • Artefact capture of reflections, rationale, and decisions to support reflection and review.
  • Suitable for learners who want to learn debugging thinking across programming tasks, multi-language environments, and complex systems.

Quick Start

To begin, load the Guided Debugging Skill in your learning session and respond to each gate with detailed, thoughtful input.

Frequently Asked Questions about guided-debugging

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

FAQPage Schema
What is Socratic debugging and how does it help with problem-solving?

Socratic debugging is a structured investigation method that uses question-based prompts to guide learners through hypothesis formation and interpretation. It improves problem-solving performance by requiring substantive input at each phase rather than providing direct fixes.

How do I learn debugging thinking without relying on automated code corrections?

You learn debugging thinking by progressing through eight phased workflows with gate-driven progression. You must provide detailed, thoughtful responses to Socratic prompts at every stage, capturing your reflections and rationale as artefacts to support review.

Can I use guided debugging for complex systems and multi-language environments?

Yes, guided debugging is suitable for learners across programming tasks, multi-language environments, and complex systems. It cultivates investigation design and interpretation skills that apply universally, preventing autonomous code analysis to ensure human-driven reasoning.

What's the best way to structure a bug investigation when encountering unexpected behavior?

The best way to structure a bug investigation is using hypothesis-driven workflows with human-only gates. You form hypotheses, design investigations, and interpret results while capturing artefacts of your decisions, ensuring you drive the problem-solving process without automated corrections.

Does structured debugging with gates prevent automated fixes for my code?

Yes, structured debugging with gates intentionally prevents autonomous code analysis and automated corrections. It enforces human-only gates and Socratic questioning to cultivate your own debugging thinking, providing reference hints instead of direct fixes.