x-queue-kafka

Configures Kafka Dialer, Publisher, Subscriber with controlled retries in Go services for consumer groups and topics.

2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/pure-golang/level85 --skill x-queue-kafka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-queue-kafka
Source: https://github.com/pure-golang/level85/tree/main/.agents/skills/x-queue-kafka
Command: npx skills add https://github.com/pure-golang/level85 --skill x-queue-kafka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you implement reliable Kafka publisher/subscriber flows without mixing incompatible retry/DLX mental models or breaking adapter contracts.

Core Features & Use Cases

  • Kafka Dialer + Publisher + Subscriber setup for topic + consumer group communication.
  • Deterministic retry control via a handler contract returning (bool, error).
  • Adapter defaults awareness so you override only what matters (topic, group ID, prefetch, retry/backoff).

Quick Start

Ask for a Go example that wires Dialer, Publisher, and Subscriber for a topic and consumer group, including a handler that returns (false, nil) on success and (true, err) to retry up to MaxTryNum.

Frequently Asked Questions about x-queue-kafka

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

FAQPage Schema
How do I implement a Go Kafka publisher and consumer group subscriber with retry control?

To implement a Go Kafka publisher and consumer group subscriber with retry control, wire the Dialer, Publisher, and Subscriber components to enforce explicit topic message usage and define handler semantics using (bool, error) returns for bounded or infinite retry rules.

Why does my Kafka consumer group handler fail during topic and group configuration?

Kafka consumer group handlers often fail during topic and group configuration due to misapplied retry semantics and incorrect adapter contract requirements for Dialer, Publisher, and Subscriber construction. Enforcing explicit queue message topic usage and deterministic retry rules resolves this.

How does the handler contract returning bool and error work for Kafka retries?

The handler contract returning (bool, error) works for Kafka retries by signaling success with (false, nil) and triggering retries with (true, err). This deterministic retry control retries failed messages up to a configured MaxTryNum limit.

Do I need to configure all Kafka adapter parameters or are there defaults for topic and prefetch?

You do not need to configure all Kafka adapter parameters because adapter defaults exist. You only override what matters for your specific use case, such as the queue message topic, consumer group ID, prefetch, and retry or backoff settings.

What is the best way to avoid mixing incompatible retry and DLX mental models when integrating Kafka in Go?

The best way to avoid mixing incompatible retry and DLX mental models when integrating Kafka in Go is to use a queue Kafka adapter that enforces explicit topic-based delivery and defines strict handler semantics with bounded or infinite retry rules.

Can I use this queue Kafka adapter for infinite retries with a Go service?

Yes, you can use this queue Kafka adapter for infinite retries within a Go service. The subscriber handler semantics allow you to define both bounded retry limits up to MaxTryNum and infinite retry rules based on the returned boolean and error values.