Systematic Debugging
Systematic Debugging is an agent skill (a SKILL.md file) from obra/superpowers. Agents load it when encountering any bug, test failure, or unexpected behavior, before proposing fixes. It works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode and has 296,071 GitHub stars across a repository of 10 listed skills.
github.com/obra/superpowers/skills/systematic-debugging (opens in a new tab)
- Multi-skill repo
- Plugin marketplace
- Testing & QA
- Actively maintained
Add this skill
Claude
This repository is a Claude Code plugin marketplace. In Claude Code:
/plugin marketplace add obra/superpowers
/plugin install superpowers@superpowers-devIn the Claude apps, zip the systematic-debugging folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).
ChatGPT / Codex
Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:
git clone --depth 1 https://github.com/obra/superpowers.git
cp -r superpowers/skills/systematic-debugging .agents/skills/systematic-debugging # repo; ~/.agents/skills for all projectsStandalone skills also load in the ChatGPT desktop app.
Cursor
Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:
git clone --depth 1 https://github.com/obra/superpowers.git
cp -r superpowers/skills/systematic-debugging .cursor/skills/systematic-debugging # project; ~/.cursor/skills for all projectsSource (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), code.claude.com/docs/en/plugin-marketplaces (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)
What this skill does
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes Core principle: ALWAYS find root cause before attempting fixes. Symptom fixes are failure.
More skills in obra/superpowers
10 skills are listed from this repository.
Brainstormingobra/superpowers
Similar skills
More testing & qa skills
TDD
mattpocock/skills
Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.
Testing & QAShellDiagnosing Bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions.
Testing & QAShellSetup Pre Commit
mattpocock/skills
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo.
Testing & QAShellScaffold Exercises
mattpocock/skills
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting.
Testing & QAShellMigrate To Shoehorn
mattpocock/skills
Migrate test files from as type assertions to @total-typescript/shoehorn.
Testing & QAShellGolang Testing
affaan-m/ECC
Go testing patterns including table-driven tests, subtests, benchmarks, fuzzing, and test coverage.
Testing & QAJavaScript
What is the Systematic Debugging skill?
Systematic Debugging is an agent skill (a SKILL.md file) from obra/superpowers. Agents load it when encountering any bug, test failure, or unexpected behavior, before proposing fixes. It works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode and has 296,071 GitHub stars across a repository of 10 listed skills. Its SKILL.md lives at github.com/obra/superpowers/skills/systematic-debugging.
How do I install the Systematic Debugging skill?
In Claude Code, run /plugin marketplace add obra/superpowers and then /plugin install superpowers@superpowers-dev. For Codex or Cursor, copy the systematic-debugging folder into .agents/skills/ or .cursor/skills/.
Is the Systematic Debugging skill free?
Yes. The repository is open source under the MIT license.
Is Systematic Debugging maintained?
The repository's most recent commit was on Sep 25, 2026. Its latest release is v6.4.2. appsgit only lists skills from repositories with a commit in the last six months.