Skip to main content
skill CX Codex

414-frameworks-quarkus-kafka — Claude Code skill: setup guide

414-frameworks-quarkus-kafka guides Kafka messaging setups in Quarkus using SmallRye Reactive Messaging. Useful for channel tuning, serialization, and DLQ failure handling.

Apache-2.0 279 installs ★ 465 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a claude-code
Open on GitHub

What 414-frameworks-quarkus-kafka does

This skill delivers guidelines for Kafka messaging inside Quarkus applications. It covers SmallRye Reactive Messaging patterns: channel and topic configuration, Jackson serialization at build time, typed @Channel and @Incoming declarations, acknowledgement models, retry pipelines, dead-letter queues (DLQ), idempotency, plus testing setups using Dev Services and Testcontainers.

The workflow enforces strict compilation gates. The agent must run ./mvnw compile or mvn compile prior to applying any code edits. If compilation breaks, execution halts immediately. Every refactoring round ends with mandatory ./mvnw clean verify testing.

What it helps with

  • configure SmallRye Reactive Messaging Kafka channels and topics
  • implement failure strategies and dead-letter queues in Quarkus
  • set up typed @Channel and @Incoming event handlers
  • verify consumer idempotency and retry semantics
  • validate reactive producers using Dev Services and Testcontainers

Example prompts for the agent

  • Add Kafka messaging to this Quarkus app using typed @Channel annotations
  • Configure a dead-letter queue failure strategy for our incoming Kafka channel
  • Review Quarkus Reactive Messaging consumers and run verification tests

How to install 414-frameworks-quarkus-kafka

1Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a claude-code

2Manually: put the files in place

~/.claude/skills/414-frameworks-quarkus-kafka/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/414-frameworks-quarkus-kafka/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 414-frameworks-quarkus-kafka

How to install 414-frameworks-quarkus-kafka in Claude Code?

Run npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a claude-code in your terminal.

What does 414-frameworks-quarkus-kafka do?

It guides coding agents through Quarkus Kafka implementations using SmallRye Reactive Messaging, serialization patterns, and resilience settings.

What is the mandatory verification step before refactoring?

You must execute ./mvnw compile or mvn compile; any compilation failure stops the workflow right away.

Source text

SKILL.md · Apache-2.0
---
name: 414-frameworks-quarkus-kafka
description: Use when you need Kafka messaging in Quarkus with SmallRye Reactive Messaging — including channel/topic design, build-time Jackson serialization, typed @Channel/@Incoming, ack/failure strategies, retries/DLQ, idempotency, Dev Services, and Testcontainers integration tests. This should trigger for requests such as Add Kafka in Quarkus; Review Reactive Messaging consumers; Improve failure handling for Quarkus Kafka; Configure Quarkus Reactive Messaging Kafka channels; Add Quarkus Kafka failure strategy or DLQ handling. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Quarkus — Kafka messaging

Apply Quarkus Kafka guidance with concrete examples for design, implementation, and error handling.

## Constraints

Compile before messaging refactors; verify after changes.

- **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any change
- **SAFETY**: If compilation fails, stop immediately
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements
- **BEFORE APPLYING**: Read the reference for detailed rules and examples

## When to use this skill

- Add Kafka in Quarkus
- Review Quarkus Reactive Messaging consumers/producers
- Improve retries, dead-letter handling, or idempotency in Quarkus Kafka
- Configure Quarkus Reactive Messaging Kafka channels
- Add Quarkus Kafka failure strategy or DLQ handling

## Workflow

1. **Read reference and assess project context**

Read `references/414-frameworks-quarkus-kafka.md` and inspect current messaging setup before proposing changes.

2. **Gather scope and decide target improvements**

Identify delivery semantics and resilience goals to define safe improvements.

3. **Apply framework-aligned changes**

Implement/refactor channels, serializers, and failure strategies in Reactive Messaging.

4. **Run verification and report results**

Execute build/tests and summarize what changed, what was verified, and follow-up actions.

## Reference

For detailed guidance, examples, and constraints, see [references/414-frameworks-quarkus-kafka.md](references/414-frameworks-quarkus-kafka.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Similar skills

All skills for Backend and APIs →

From the same set123

The whole set →
404-frameworks-quarkus-security 404-frameworks-quarkus-security is a skill for designing and reviewing security in Quarkus applications, including authentication, access control, and secure logging. CX Codex +1 294installs 315-frameworks-spring-mongodb 315-frameworks-spring-mongodb — a skill for designing and implementing MongoDB data access in Spring Boot. Covers document modeling, repositories, indexing, optimistic locking, and error handling strategies. CX Codex +1 284installs 504-frameworks-micronaut-security The 504-frameworks-micronaut-security skill reviews and improves Micronaut application security, covering authentication, route authorization, JWT, CORS, and safe handling of sensitive data. CX Codex +1 282installs 503-frameworks-micronaut-validation 503-frameworks-micronaut-validation guides validation setup in Micronaut applications, from Bean Validation annotations to HTTP 400 error payloads. CX Codex +1 280installs 415-frameworks-quarkus-mongodb Skill for MongoDB in Quarkus projects: Panache entities and repositories, document design, indexes, transactions, and error handling. Triggers on requests to add MongoDB, review architecture, and optimize data access patterns. CX Codex +1 279installs 514-frameworks-micronaut-kafka 514-frameworks-micronaut-kafka guides Kafka messaging setup in Micronaut applications. Covers producers, consumers, SerDes configuration, retry handling, and integration tests. CX Codex +1 275installs 515-frameworks-micronaut-mongodb The 515-frameworks-micronaut-mongodb skill guides MongoDB work in Micronaut, from document models and repositories to indexes and error handling. Use it when adding or reviewing persistence. CX Codex +1 272installs 123-java-design-patterns The 123-java-design-patterns skill helps choose, review, and apply Java patterns for APIs, Kafka, persistence, and integrations. CX Codex +1 267installs

Project sponsors

Companies that keep this analytics open