doey-debug

Toggle and record Doey hook activity to diagnose timing, lifecycle events, and IPC messages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps developers observe and record Doey hook activity to diagnose timing, state transitions, and IPC issues in complex workflows.

Core Features & Use Cases

  • Enable flight-recorder for Doey hooks to capture timing, lifecycle events, and IPC messages.
  • Toggle recording on/off in real-time to diagnose bugs across multiple panes.
  • Review collected logs to identify race conditions and IPC bottlenecks.

Quick Start

Run /doey-debug on to start recording and view the generated logs in the DOEY_RUNTIME debug directory.

Frequently Asked Questions about doey-debug

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

FAQPage Schema
How do I debug IPC timing and lifecycle events in multi-pane workflows?

To debug IPC timing and lifecycle events, toggle Doey hook flight-recording to capture and correlate activity across dashboard and workers. It records per-pane logs to help pinpoint race conditions and message bottlenecks.

How do I start recording hook activity to diagnose state transitions?

Start recording hook activity by running the toggle command to enable flight-recorder mode. Generated logs are collected in the DOEY_RUNTIME debug directory for reviewing state transitions and IPC messages.

Can I toggle hook debugging on and off in real-time during development?

Yes, you can toggle hook debugging on and off in real-time during development. This allows you to safely isolate and diagnose bugs across multiple panes without disrupting the running environment.

Does flight-recording hook activity require any special environment setup?

Flight-recording hook activity requires no special setup, utilizing a configurable startup state and environment-based toggles. This ensures safe, non-intrusive operation during development.

What is the best way to identify race conditions across dashboard and workers?

The best way to identify race conditions is enabling flight-recorder for Doey hooks to capture timing and IPC messages. Reviewing the collected per-pane logs helps target multi-pane workflow bottlenecks.