agent-introspection-debugging

Diagnose AI agent execution failures through a four-phase recovery workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves stalled or looping AI agent processes by providing a structured framework for diagnosing failures, preventing token waste, and implementing targeted recovery actions.

Core Features & Use Cases

  • Failure Capture: Standardizes the logging of error types, tool call sequences, and environment states to provide clear diagnostic data.
  • Root-Cause Diagnosis: Offers a decision matrix to identify common failure patterns like context overflow, service timeouts, or logic drift.
  • Contained Recovery: Enables safe, incremental corrective actions that avoid blind retries and minimize further system instability.

Quick Start

Invoke the agent-introspection-debugging skill to analyze the current failure and generate a recovery 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 troubleshoot an AI agent stuck in a tool call loop?

To troubleshoot an AI agent stuck in a tool call loop, apply a structured diagnostic framework to capture the failure, diagnose the root cause, and execute contained recovery. This prevents token waste and resolves the looping process safely.

Why does my AI agent experience context degradation during execution?

AI agent context degradation occurs during execution due to environment state mismatches or context overflow. Identifying these failure patterns requires standardizing error logs and applying a root-cause decision matrix to isolate the exact issue.

What is the best way to resolve stalled AI agent processes without wasting tokens?

The best way to resolve stalled AI agent processes is implementing targeted, incremental corrective actions rather than blind retries. This contained recovery approach minimizes further system instability and prevents unnecessary token consumption.

How do I diagnose environment state mismatches in AI agent workflows?

Diagnose environment state mismatches in AI agent workflows by standardizing the logging of error types, tool call sequences, and environment states. This failure capture provides the diagnostic data needed for root-cause analysis.

Can I use a systematic debugging framework for AI agent logic drift?

Yes, you can use a systematic debugging framework for AI agent logic drift. It provides a four-phase workflow encompassing failure capture, root-cause diagnosis, contained recovery, and introspection reporting to resolve logic issues.

When should I avoid blind retries for AI agent execution failures?

You should avoid blind retries for AI agent execution failures when system instability is a risk. Instead, use contained recovery actions that incrementally correct the failure and generate an introspection report for safe resolution.