debug-plugin-hooks

Trace plugin hook execution failures and event flow disruptions in Kollab's event system.

1|Updated May 5, 2026
One-click install
npx skills add https://github.com/kollaborai/kollab --skill debug-plugin-hooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-plugin-hooks
Source: https://github.com/kollaborai/kollab/tree/main/bundles/skills/debug-plugin-hooks
Command: npx skills add https://github.com/kollaborai/kollab --skill debug-plugin-hooks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork when debugging plugin hook issues in Kollab's event system, resolving problems like hooks not executing, running in the wrong order, timing out, or causing unexpected event cancellation.

Core Features & Use Cases

  • Registered Hook Discovery: List all hooks registered for any event type, view their priority, status, and associated plugin.
  • Event Flow Tracing: Trace how events move through pre/main/post processing phases to identify bottlenecks or broken execution paths.
  • Issue Diagnosis: Step-by-step troubleshooting for common hook failures including timeouts, errors, priority conflicts, and event cancellation.
  • Use Case: If your custom Kollab plugin hook that modifies user input is not triggering, use this Skill to verify the hook is registered, enabled, and assigned the correct priority for the USER_INPUT event type.

Quick Start

Use the debug-plugin-hooks skill to diagnose why your custom Kollab plugin hook is not firing when user input is submitted.

Frequently Asked Questions about debug-plugin-hooks

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

FAQPage Schema
Why is my Kollab plugin hook not executing when an event is triggered?

Plugin hook execution failures in Kollab often stem from incorrect registration, disabled status, or priority conflicts. You can inspect registered hook metadata and verify the hook is enabled and assigned the correct priority for the target event type.

How do I trace event flow through pre, main, and post processing phases in Kollab?

To trace event flow in Kollab, you trace how events move through the pre, main, and post processing phases. This identifies bottlenecks or broken execution paths by using Kollab's built-in event bus and logging tools.

What is the best way to debug hook priority conflicts in a Kollab plugin?

The best way to debug hook priority conflicts is to list all hooks registered for the event type and view their assigned priorities. This reveals execution order issues across the Kollab event system registry.

How do I diagnose event cancellation or timeout issues in Kollab plugin hooks?

To diagnose event cancellation and hook timeouts, apply step-by-step troubleshooting to inspect the event bus and registry. This isolates the root cause of failures during pre, main, or post phase event processing.

Can I view all registered hooks for a specific Kollab event type?

Yes, you can list all hooks registered for any Kollab event type. This discovery process displays the priority, status, and associated plugin for each hook to help troubleshoot execution failures.