agent-introspection-debugging

Diagnoses AI agent failures and generates structured introspection reports.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/ldk-hub/broke-shopping --skill agent-introspection-debugging-ldk-hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-introspection-debugging
Source: https://github.com/ldk-hub/broke-shopping/tree/main/.agent/.agents/skills/agent-introspection-debugging
Command: npx skills add https://github.com/ldk-hub/broke-shopping --skill agent-introspection-debugging-ldk-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured self-debugging workflow to help AI agents recover from failures by capturing, diagnosing, containing recovery, and producing introspection reports.

Core Features & Use Cases

  • Capture failure state precisely to avoid blind retries.
  • Diagnose common agent-specific failure patterns and guide contained recovery.
  • Generate an introspection report to inform humans and future improvements.

Quick Start

Start the agent introspection workflow when an agent run falters to begin the four-phase loop and produce a recoverable 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 repeated tool-call loop?

Agent introspection works by capturing the exact failure state, diagnosing root causes like context drift, and producing structured recovery evidence. It operates through a four-phase debugging loop to prevent blind retries and inform future improvements.

Why does my AI agent experience context drift and state mismatches during a run?

AI agents experience context drift and state mismatches when internal execution state diverges from expected parameters. Structured self-debugging diagnoses these root causes by capturing the exact failure state and generating an introspection report for contained recovery.

What is the best way to structure failure analysis for faltering AI agent runs?

The best way to structure failure analysis for faltering agent runs is using a four-phase loop: failure-capture, root-cause diagnosis, contained recovery, and introspection report generation. This workflow produces structured recovery evidence to inform human verification.

Can I use introspection reports to prevent future AI agent failures?

Yes, you can use introspection reports to prevent future AI agent failures. The reports generate structured recovery evidence that integrates with workflow guidelines to verify fixes, guide contained recovery, and improve future agent learning.

Do I need a defined failure-capture format before starting agent debugging?

Yes, you need a defined failure-capture format before starting agent debugging. The introspection workflow requires defined formats for failure-capture, root-cause diagnosis, and introspection reports to successfully execute contained recovery and generate structured evidence.