Skip to main content
skill CX Codex

314-frameworks-spring-kafka — Claude Code skill: setup guide

314-frameworks-spring-kafka guides Kafka messaging setup in Spring Boot projects, covering consumers, DLT retries, and Testcontainers.

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

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

What 314-frameworks-spring-kafka does

This skill guides the design and refactoring of Apache Kafka messaging within Spring Boot services. It covers topic design, producer and consumer configurations, JSON serialization via Boot factory customizers, idempotency, and dead-letter topic error handling.

The workflow enforces strict compilation gates before editing code. You must run ./mvnw compile or mvn compile prior to applying messaging refactors, stopping immediately on build failures, and conclude with ./mvnw clean verify.

What it helps with

  • configure Spring Boot Kafka producers and listener containers
  • set up retries and dead-letter topic handling
  • implement integration tests using Testcontainers @ServiceConnection
  • apply JSON serialization factory customizers

Example prompts for the agent

  • Add Spring Kafka dead-letter topic handling for payment events
  • Review Spring Kafka consumers and listener container configs
  • Configure Spring Boot Kafka integration test with Testcontainers @ServiceConnection

How to install 314-frameworks-spring-kafka

1Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 314-frameworks-spring-kafka -a claude-code

2Manually: put the files in place

~/.claude/skills/314-frameworks-spring-kafka/SKILL.md

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

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

Questions about 314-frameworks-spring-kafka

How to install 314-frameworks-spring-kafka in Claude Code?

Run npx skills add jabrena/plinth --skill 314-frameworks-spring-kafka -a claude-code. The skill file will be placed at ~/.claude/skills/314-frameworks-spring-kafka/SKILL.md.

What does 314-frameworks-spring-kafka do?

It provides structured steps and constraints for implementing Kafka messaging, error handling, and tests in Spring Boot applications.

What verification step is required before modifying code?

Running ./mvnw compile or mvn compile is mandatory before changes, and the process stops immediately if compilation fails.

Source text

SKILL.md · Apache-2.0
---
name: 314-frameworks-spring-kafka
description: Use when you need to design or implement Kafka messaging in Spring Boot — including topic design, producer/consumer implementation, JSON serialization with Boot factory customizers, Testcontainers `@ServiceConnection` integration tests, retries and dead-letter topics, idempotency, and error handling. This should trigger for requests such as Add Kafka in Spring Boot; Review Spring Kafka consumers; Improve retries and DLT in Spring Kafka; Configure Spring Kafka topics serializers or listener containers; Add Spring Kafka dead-letter topic handling. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Spring Boot — Kafka messaging

Apply Spring 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 Spring Boot
- Review Spring Kafka consumers/producers
- Improve retries, dead-letter topics, or idempotency in Spring Kafka
- Configure Spring Kafka topics serializers or listener containers
- Add Spring Kafka dead-letter topic handling

## Workflow

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

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

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

Identify reliability and throughput goals and define the minimum safe set of changes.

3. **Apply framework-aligned changes**

Implement/refactor Spring Kafka configuration, producer/consumer logic, and failure handling.

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/314-frameworks-spring-kafka.md](references/314-frameworks-spring-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 →
002-agents-inventory 002-agents-inventory — a skill to auto-generate a checklist with an embedded Java agent inventory. Produces INVENTORY-AGENTS-JAVA.md by strictly following a template, preserving exact structure and content. CX Codex +1 314installs 043-planning-github-issues 043-planning-github-issues guides GitHub CLI setup and keeps issue prose outside agent context, relying on repository-owned documents for requirements analysis. CX Codex +1 312installs 126-java-exception-handling 126-java-exception-handling is a Claude Code skill for Java exception handling. It activates on requests to review error types, resource cleanup, or failure propagation. CX Codex +1 307installs 703-technologies-fuzzing-testing The 703-technologies-fuzzing-testing skill guides CATS-based fuzz testing for Java APIs from an OpenAPI contract. Use it to probe invalid inputs, boundary conditions, and CI checks. CX Codex +1 304installs 182-java-observability-metrics-micrometer 182-java-observability-metrics-micrometer guides Java developers through Micrometer metrics design and validation. Use it when adding service measurements or revising existing instrumentation. CX Codex +1 297installs 403-frameworks-quarkus-validation 403-frameworks-quarkus-validation guides Quarkus validation work, from DTO constraints and REST boundaries to configuration checks and API error mapping. CX Codex +1 296installs 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

Project sponsors

Companies that keep this analytics open