skills.rest
Tzeusy
TzeusyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

butler-dev-debug

Debug Butler framework sessions by analyzing logs and querying PostgreSQL.

Updated Feb 9, 2026
Search Tags:#debugging#postgresql#logs#session#runtime errors#butler
One-click install
npx skills add https://github.com/Tzeusy/butlers --skill butler-dev-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: butler-dev-debug
Source: https://github.com/Tzeusy/butlers/tree/main/.claude/skills/butler-dev-debug
Command: npx skills add https://github.com/Tzeusy/butlers --skill butler-dev-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers and operators diagnose and resolve issues within the Butler framework by providing tools to investigate session failures, trace requests, and analyze runtime errors.

Core Features & Use Cases

  • Session Investigation: Debug specific failed sessions using session IDs, querying PostgreSQL databases, and analyzing structured logs.
  • Runtime Error Analysis: Inspect process logs and tool call outcomes to pinpoint the root cause of butler malfunctions.
  • Use Case: When a user reports a specific task failed, you can use this Skill to retrieve the session ID, query its details from the database, examine the prompt and result, and check associated tool calls and process logs to understand why it failed.

Quick Start

Investigate a failed session using its ID by searching the logs and querying the PostgreSQL database.

Frequently Asked Questions about butler-dev-debug

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

FAQPage Schema
How do I debug failed Butler framework sessions and trace runtime errors?▼

Debug failed Butler framework sessions by retrieving the session ID, querying the PostgreSQL database for details, and analyzing structured logs. Inspect prompt results and tool call outcomes to pinpoint the root cause of butler malfunctions and runtime exceptions.

What's the best way to investigate Butler routing failures and tool call errors?▼

Investigate Butler routing failures by inspecting process logs and examining tool call outcomes. Structured log analysis reveals where routing failed, while API inspection helps verify the request flow and identify the exact tool call errors causing runtime exceptions.

How do I find the root cause of a specific Butler task failure using a session ID?▼

Find the root cause of a Butler task failure by searching structured logs with the specific session ID. Query the PostgreSQL database to retrieve session details, examine the original prompt and result, and check associated tool calls to understand why it failed.

Do I need PostgreSQL and log access to troubleshoot Butler runtime exceptions?▼

You need PostgreSQL database access and butler log access to troubleshoot runtime exceptions comprehensively. These dependencies allow you to query session details and perform structured log analysis to resolve routing failures and tool call errors effectively.

Can I inspect the Butler dashboard API to diagnose session failures?▼

You can inspect the dashboard API to diagnose Butler session failures. API inspection provides additional context alongside PostgreSQL queries and structured log analysis, enabling comprehensive issue resolution for failed routing and general butler runtime exceptions.

Why does my Butler session fail with a runtime error during tool calls?▼

Butler sessions fail with runtime errors during tool calls due to processing exceptions or routing failures. Analyze process logs and inspect tool call outcomes to identify the specific error point, then query PostgreSQL session records to trace the failure source.

Related Skills

Explore More Software Engineering Skills→
ammonfifeammonfife

search-sessions

Locate and search session logs across BigMac platforms and Turso databases.

Community
Advanced
fmflurryfmflurry
171

runtimeerror-http-localhost-error-resolution

Identify and resolve recurring runtime errors with a structured error-resolution pattern.

Community
Intermediate
lookleelooklee

debug

Enable session debug logging and analyze logs for errors and warnings.

Community
Intermediate
TestAny-ioTestAny-io
79

debug

Diagnose Testany test failures by analyzing execution logs and identifying root causes.

Official
Intermediate