agent-introspection-debugging

Capture agent error state and tool usage to diagnose repeated failures.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/sakamoto-family-smile/agent_monorepo --skill agent-introspection-debugging-sakamoto-family-smile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-introspection-debugging
Source: https://github.com/sakamoto-family-smile/agent_monorepo/tree/main/.claude/skills/ecc/agent-introspection-debugging
Command: npx skills add https://github.com/sakamoto-family-smile/agent_monorepo --skill agent-introspection-debugging-sakamoto-family-smile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Captures and analyzes repeated agent failures to stop token waste, looping on tools, and drift from the objective by guiding systematic failure state capture and diagnosis before escalation.

Core Features & Use Cases

  • Failure capture: records error type, message, stack traces, last successful step, and relevant context to ground analysis.
  • Root-cause diagnosis: matches failures to known patterns and suggests targeted, minimal remedies.
  • Contained recovery: applies safe, incremental fixes to restore progress without broad state mutations.
  • Introspection reporting: generates a structured, human-readable report summarizing findings and actions taken.
  • ECC integration: aligns with verification loops and continuous-learning workflows for robust resilience.

Quick Start

Activate the workflow to capture the failure, diagnose the root cause, apply contained recovery, and generate an introspection report.

Frequently Asked Questions about agent-introspection-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug an AI agent stuck in a tool loop?

To debug an agent stuck in a tool loop, this skill captures the error state and tool usage to diagnose the root cause and apply contained recovery steps to restore progress without broad state mutations.

Why does my agent drift from the objective and drain tokens?

Agent drift and token drain happen when repeated failures go undiagnosed. This skill captures structured failure states, matches them to known patterns, and suggests minimal remedies to stop the waste.

What is the best way to capture error states for agent introspection?

The best way to capture error states for agent introspection is to record the error type, message, stack traces, last successful step, and relevant context to ground your root-cause analysis.

Can I use structured self-debugging for agent runs in production?

Yes, you can use structured self-debugging for agent runs in production. It identifies recurring loops and drift from the objective across both development and production contexts to generate an actionable report.

How do I generate an introspection report after an agent failure?

To generate an introspection report after an agent failure, activate the workflow to capture the failure, diagnose the root cause, apply contained recovery, and output a structured human-readable summary of findings and actions.