Agent Introspection Debugging

When your agent hits max tool calls, loops on the same command, or burns tokens without progress, this gives it a structured way to debug itself before you step in. It walks through capture, diagnosis, contained recovery, and a final introspection report. The core idea is solid: match the failure to a known pattern like context overflow or service timeouts, then take the smallest reversible action that changes the situation. The four phase loop keeps things systematic instead of retrying blindly with slightly different wording. Pairs naturally with verification-loop after code changes and works best when you need the agent to stop, assess what actually broke, and produce a legible report instead of just claiming it fixed something.

Install to Claude Code

npx -y skills add affaan-m/ecc --skill agent-introspection-debugging --agent claude-code