# ce-debug

> Claude/Codex skill by [@everyinc](https://omgskills.com/library/everyinc/index.md) · 26k stars · Updated 2026-10-17

Diagnosis loop for bugs and failing behavior. Use when asked to debug or fix failing or slow behavior.

Tags: compound, engineering

## Install

```sh
git clone https://github.com/EveryInc/compound-engineering-plugin /tmp/compound-engineering-plugin && ln -s /tmp/compound-engineering-plugin/skills/ce-debug ~/.claude/skills/ce-debug
```

## From README

Debug and Fix Find the root cause of a failure, then — when the user chooses to — fix it with test-first discipline. Done when: the causal chain from trigger to symptom is stated with no gaps and file:line evidence, and either a verified fix has been handed off (PR, commit, or the user's chosen stop) or a diagnosis-only summary has been delivered. Escalate rather than persist: 2-3 hypotheses exhausted without confirmation, or 3 failed fix attempts, means diagnose why instead of trying again — that is the smart escalation references/investigate.md describes. One hypothesis, one change at a time; changing several to see what helps is shotgun debugging. is whatever this skill was invoked with — a failure description, a mode: token, or an issue reference (\#123, org/repo\#123, an issue URL) — from the user or from a calling skill (ce-babysit-pr / lfg in mode:pipeline pass the failing jobs and log tails; lfg's defect route passes mode:return-to-caller and the user's own reference).

## Links

- HTML page: https://omgskills.com/library/everyinc/compound-engineering-plugin/ce-debug/
- GitHub: https://github.com/EveryInc/compound-engineering-plugin
- Author: [@everyinc](https://omgskills.com/library/everyinc/index.md)

## More from this repo

- [ce-brainstorm](https://omgskills.com/library/everyinc/compound-engineering-plugin/ce-brainstorm/index.md) — Explore vague or ambitious ideas into a right-sized requirements-only unified plan.
   - [@everyinc](https://omgskills.com/library/everyinc/index.md) · 26k stars
- [ce-babysit-pr](https://omgskills.com/library/everyinc/compound-engineering-plugin/skills/ce-babysit-pr/index.md) — Babysits an open GitHub PR until merge-ready, first judging whether an old PR still belongs.
   - [@EveryInc](https://omgskills.com/library/everyinc/index.md) · 26k stars
- [ce-commit](https://omgskills.com/library/everyinc/compound-engineering-plugin/ce-commit/index.md) — Used to create a git commit with a clear, value-communicating message.
   - [@everyinc](https://omgskills.com/library/everyinc/index.md) · 26k stars
