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
npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/414-frameworks-quarkus-kafka/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/414-frameworks-quarkus-kafka/
1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a codex2Manually: put the files in place
.agents/skills/414-frameworks-quarkus-kafka/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a cursor2Manually: put the files in place
.cursor/skills/414-frameworks-quarkus-kafka/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/414-frameworks-quarkus-kafka2Manually: put the files in place
.github/skills/414-frameworks-quarkus-kafka/SKILL.md1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a gemini-cli2Platform CLI
gemini skills install https://github.com/jabrena/plinth --path skills/414-frameworks-quarkus-kafkaManually: put the files in place
.devin/skills/414-frameworks-quarkus-kafka/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 414-frameworks-quarkus-kafka -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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