ce-debug

Installation
SKILL.md

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 (Smart escalation) instead of trying again.

The bug description is the input this skill was invoked with — the failure to diagnose, present in the current prompt or conversation, whether the user provided it directly or a calling skill passed it (e.g. ce-babysit-pr / lfg in mode:pipeline, which pass the failing jobs and log tails as the argument). It may be a description of the failure, a mode: token, or an issue reference (#123, org/repo#123, or an issue URL). The rest of this skill refers to it as <bug_description>; if nothing was provided, treat <bug_description> as blank.

Setup

Run this once at the start of this invocation, before any subagent dispatch, and follow the directives it prints — except where one conflicts with this skill's own rules on asking the user questions, whether those rules are scoped to a non-interactive mode or apply in every mode, in which case this skill's rules win and no blocking question is asked. Run the fence exactly as written, as its own command: do not pipe or filter it (no head, tail, or grep), do not truncate its output, and do not bundle it into a batch with other commands. Its output opens with a === skill context header and ends with CE_CONTEXT_END; if you received one of those lines without the other, the output was truncated — rerun the fence verbatim once. That recovery is the only rerun: otherwise do not rerun it within the same invocation; a later invocation of this or any other skill runs its own. If no Node runtime is available the skill proceeds unchanged.

Installs
2.6K
GitHub Stars
24.3K
First Seen
Apr 10, 2026
ce-debug — everyinc/compound-engineering-plugin