Skill definition
hi-debug
Debug systematically with root cause analysis before fixes. Use for bugs, test failures, unexpected behavior, performance issues, call stack tracing, multi-layer validation, log analysis, CI/CD failures, database diagnostics, system investigation.
SKILL.md
Debugging & System Investigation
NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. See references/verification.md for the Iron Law, Red Flags, and Rationalization Prevention.
Techniques
| # | Technique | File | Load when |
|---|---|---|---|
| 1 | Systematic Debugging | references/systematic-debugging.md | Any bug/issue requiring investigation and fix |
| 2 | Root Cause Tracing | references/root-cause-tracing.md | Error deep in call stack, unclear where invalid data originated |
| 3 | Defense-in-Depth | references/defense-in-depth.md | After finding root cause, need comprehensive validation |
| 4 | Verification | references/verification.md | About to claim work complete, fixed, or passing |
| 5 | Investigation Methodology | references/investigation-methodology.md | Server incidents, system behavior analysis, multi-component failures |
| 6 | Log & CI/CD Analysis | references/log-and-ci-analysis.md | CI/CD pipeline failures, server errors, deployment issues |
| 7 | Performance Diagnostics | references/performance-diagnostics.md | Performance degradation, slow queries, high latency, resource exhaustion |
| 8 | Reporting Standards | references/reporting-standards.md | Need to produce investigation report or diagnostic summary |
| 9 | Task Management | references/task-management-debugging.md | Multi-component investigation (3+ steps), parallel log collection, coordinating debugger subagents |
| 10 | Frontend Verification | references/frontend-verification.md | Implementation touches frontend files (tsx/jsx/vue/svelte/html/css), UI bugs, visual regressions |
Tools Integration
- Database/CI:
psqlfor PostgreSQL;ghCLI for GitHub Actions logs and pipelines - Codebase:
hi-docs-seeker(package docs),hi-repo-search(summary),/hi-explorer(explorer files) - Frontend/Problem-solving: Chrome browser or
hi-chrome-devtoolsfor visual verification;hi-problem-solvingwhen stuck
Continue exploring
Related skills
hi-fixALWAYS activate before fixing ANY bug, error, test failure, CI/CD issue, type error, lint, log error, UI issue, code problem.hi-securitySTRIDE + OWASP-based security audit with MCP-assisted code analysis and optional iterative auto-fix. Scans code using graph_mcp for structure discovery and mind_mcp for security policy context, then produces severity-ranked findings with fix recommendations. Supports audit-only and audit+fix modes. Use before releases, after sensitive feature additions, or for periodic compliance reviews.hi-chrome-devtoolsBrowser automation via Puppeteer CLI scripts with persistent sessions. Screenshots, performance, network, scraping, form automation, auth, debugging.