# Debug

> Systematic debugging workflow for bugs and test failures

- Skill: `hivellm/debug` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hivellm/debug`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hivellm/debug/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: hivellm (https://skillmd.com/u/hivellm)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/hivellm/debug

---

Debug the following issue: $ARGUMENTS

Steps:
1. Reproduce the issue by reading the error message or running the failing test
2. Read the relevant source code and trace the execution path
3. Form a hypothesis about the root cause
4. Search for similar patterns in the codebase that work correctly
5. Identify the exact root cause with file and line reference
6. Propose a minimal fix with explanation