agent-introspection-debugging

Diagnose AI agent failures and generate structured introspection reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured, repeatable debugging workflow for AI agents that fail repeatedly, looping or drifting, to capture failure state, diagnose causes, apply contained recovery, and generate introspection reports.

Core Features & Use Cases

  • Four-Phase Loop: Failure Capture, Root-Cause Diagnosis, Contained Recovery, and Introspection Report.
  • Activation guidance: use when an agent hits maximum tool calls, repeated retries, or context drift.
  • Safe, contained recovery: non-destructive retries and evidence-based fixes; produces structured reports for humans.

Quick Start

Activate the skill when you observe repeated failures and follow the four-phase loop to capture, diagnose, recover, and 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 failure loop?

AI agent failure loops are debugged using a structured four-phase workflow: capture the failure state, perform root-cause diagnosis, apply contained recovery, and generate an introspection report.

What is context drift in AI agents and how do I diagnose it?

Context drift occurs when an AI agent loses track of its operational state. Diagnose it through structured introspection that captures the failure state and performs root-cause analysis to identify the drift trigger.

How do I recover an AI agent from repeated failed tool calls safely?

Recover from repeated failed tool calls using contained recovery actions that apply non-destructive retries and evidence-based fixes, ensuring the agent safely escalates without causing system damage.

When should I use a structured self-debugging workflow for AI agent failures?

Use structured self-debugging when an AI agent hits maximum tool calls, experiences repeated retries, or suffers from context drift, requiring failure capture and root-cause analysis.

Does AI agent debugging require generating an introspection report?

AI agent debugging requires generating an introspection report to document the failure capture, root-cause analysis, and contained recovery actions, providing a structured diagnostic record for human review.