debug

Diagnose containerized agent failures by inspecting session databases and host logs.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/tharunramagiri/bookoraaagent --skill debug-tharunramagiri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/tharunramagiri/bookoraaagent/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/tharunramagiri/bookoraaagent --skill debug-tharunramagiri

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires better-sqlite3, tsx.

What problem does it solve?

This Skill provides a structured framework for troubleshooting containerized agent systems, helping you identify and fix failures in message routing, container execution, and database synchronization.

Core Features & Use Cases

  • System Diagnostics: Quickly verify the health of the host-container communication, including database connectivity and log analysis.
  • Issue Resolution: Provides clear steps to resolve common problems like silent message loss, authentication errors, and stale container states.
  • Use Case: If your agent stops responding to messages, use this Skill to inspect the inbound and outbound session databases to determine if the message reached the container or if the container exited prematurely.

Quick Start

Use the debug skill to analyze the current session logs and identify why the agent container is failing to process incoming messages.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I troubleshoot a containerized agent that stops responding to messages?

To troubleshoot a containerized agent, inspect inbound and outbound session databases to verify if messages reached the container or if it exited prematurely. Analyzing host logs helps identify failures in message routing or container lifecycle management.

What causes silent message loss in a containerized agent architecture?

Silent message loss in a containerized agent architecture is often caused by failures in message routing or database synchronization. Inspecting the session SQLite databases validates the message flow and confirms whether the container exited prematurely.

How do I inspect a SQLite session database to diagnose agent container failures?

Inspect a SQLite session database by querying inbound and outbound message records to determine if the agent container is failing to process incoming messages. This validates message flow and reveals database synchronization or routing issues.

Do I need local filesystem access to debug inter-process communication issues between containers?

Yes, you need local filesystem access to debug inter-process communication issues between containers. Resolving these operational failures requires accessing the local filesystem and SQLite database utilities to validate container state and message flow.

What is the best way to resolve stale container states in an agent architecture?

The best way to resolve stale container states in an agent architecture is to perform system diagnostics on host-container communication. Analyzing session databases and host logs provides clear steps to resolve authentication errors and stale states.