investigate/
Systematic root-cause debugging: find the cause before writing any fix
When to use this
- Before writing any bug fix to find the root cause first without guessing
- When a test is failing and the failure message alone is not enough to understand why
- When debugging a system issue that spans multiple layers (DB, API, frontend)
How to use
-
Open the template on GitHub and copy its content:
skills/investigate/SKILL.md -
Place the file inside
.claude/skills/in your project (or globally in~/.claude/to share across all projects). - Edit the Markdown content to match your project conventions, team constraints, and specific context.