# Systematic Debugging (agent 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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/obra/superpowers |
| Skill path | skills/systematic-debugging/SKILL.md |
| Skill name | systematic-debugging |
| GitHub stars | 296,071 |
| Installs on skills.sh | 280,800 |
| License | MIT |
| Skills in repo | 10 |
| Plugin marketplace | superpowers-dev |
| Official | no |
| Works with | Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode |
| Category | Testing & QA |
| Last commit | Sep 25, 2026 |

## Add this skill

### Claude Code

```sh
/plugin marketplace add obra/superpowers
/plugin install superpowers@superpowers-dev
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
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 projects
```

### Cursor

```sh
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 projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

skills.sh listing: https://www.skills.sh/obra/superpowers/systematic-debugging

---

Canonical page: https://appsgit.com/skills/obra-systematic-debugging
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.