pipeline-debug

Trace webhooks through serve, relay, and smash stages to diagnose delivery failures.

2|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/heyAyushh/hook --skill pipeline-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pipeline-debug
Source: https://github.com/heyAyushh/hook/tree/main/skills/pipeline-debug
Command: npx skills add https://github.com/heyAyushh/hook --skill pipeline-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose end-to-end webhook delivery issues across the serve, relay, and smash stages by tracing a single event through the pipeline and its Kafka topics.

Core Features & Use Cases

  • Trace a webhook through serve, relay, and smash to identify where it fails.
  • Inspect source and core Kafka topics and consumer groups to verify progress.
  • Replay messages from the dead-letter queue (DLQ) to validate fixes.
  • Review logs and envelopes to understand payload transformation and routing.

Quick Start

Kick off a debugging session by tracing a failing webhook from ingress to egress and inspecting each stage’s logs and topics.

Frequently Asked Questions about pipeline-debug

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

FAQPage Schema
How do I trace a webhook through a Kafka pipeline to find where it fails?

Trace a webhook through a Kafka pipeline by inspecting source and core topics, reviewing consumer groups, and checking stage logs to pinpoint where events drop or delay. This verifies progress from ingress to egress across serve, relay, and smash stages.

Why does my webhook event drop silently before reaching the core topic?

A webhook event drops silently before reaching the core topic due to relay routing failures or serve validation rejections. Inspect envelopes and stage logs to understand payload transformation and identify the exact point of failure in the pipeline.

Can I replay messages from a dead-letter queue to validate webhook fixes?

You can replay messages from the dead-letter queue (DLQ) to validate webhook delivery fixes. Replaying failed events allows you to test corrections and confirm successful processing through the serve, relay, and smash stages.

What is the best way to diagnose end-to-end webhook delivery issues across multiple stages?

The best way to diagnose end-to-end webhook delivery issues is to trace a single event through the serve, relay, and smash stages. Guided checks, log inspection, and topic verification reveal where payload transformation or routing breaks down.

How do I verify consumer group progress for a failing webhook event?

Verify consumer group progress for a failing webhook event by inspecting source and core Kafka topics. Checking consumer group offsets and reviewing event envelopes confirms whether the payload stalled during relay routing or core topic inspection.

When should I inspect event envelopes during webhook debugging?

Inspect event envelopes during webhook debugging when you need to understand payload transformation and routing across the pipeline. Reviewing envelopes alongside stage logs helps diagnose why webhooks fail serve validation or relay routing.