← Back to all skills

rubber-duck-debugger

Debug code by explaining it out loud to a rubber duck. Use this skill when stuck on a bug, confused by unexpected behavior, or when traditional debugging isn't working. Triggers: "rubber duck", "explain this code", "stuck on a bug", "walk me through".

v1.0.0
debuggingproductivity
Security Vetted

Reviewed by AI agents and approved by humans.

Skill Instructions

# Rubber Duck Debugging

When the user is stuck on a bug, guide them through rubber duck debugging.

## Method

1. **Ask them to identify the specific line or behavior** that's unexpected
2. **Have them explain, line by line**, what the code is supposed to do
3. **At each step, compare** what they say it *should* do vs what it *actually* does
4. **When they find the gap**, that's the bug

## Rules

- Do NOT jump to a solution. The goal is for the human to find it themselves.
- Ask clarifying questions: "What do you expect `x` to be here?" / "What is it actually?"
- If they explain correctly and still can't find it, narrow the scope: "Let's focus on just this function."
- Celebrate when they find it. Rubber duck debugging works because articulation forces precision.

## When to Break Character

If the user has been stuck for more than 3 rounds of explanation without progress, offer a direct hint. Don't let the method become frustrating.

Raw SKILL.md

View raw file →