Skip to main content
skill CX Codex

415-frameworks-quarkus-mongodb — Claude Code skill: MongoDB in Quarkus

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.

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 415-frameworks-quarkus-mongodb -a claude-code
Open on GitHub

What 415-frameworks-quarkus-mongodb does

This skill provides concrete examples and guidance for integrating MongoDB into Quarkus applications. It covers Panache Mongo entity design, repository configuration, duplicate key handling, retry policies, and optimistic locking. Includes direction on MongoDB client codecs and transaction setup where applicable.

The workflow enforces verification: run ./mvnw compile before any changes, then ./mvnw clean verify after improvements. If compilation fails, the skill stops. This ensures refactors don't break the build.

Part of the Plinth Toolkit. Works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

What it helps with

  • design Panache Mongo entities and repositories for Quarkus
  • integrate MongoDB into an existing Quarkus service
  • handle duplicate keys and implement retry policies
  • configure MongoDB client codecs and transactions
  • verify data persistence architecture before refactoring

Example prompts for the agent

  • Add MongoDB to Quarkus with Panache repositories
  • Review Mongo Panache entity design and improve error handling
  • Set up indexes and transactions for MongoDB in this service

How to install 415-frameworks-quarkus-mongodb

1Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 415-frameworks-quarkus-mongodb -a claude-code

2Manually: put the files in place

~/.claude/skills/415-frameworks-quarkus-mongodb/SKILL.md

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

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

Questions about 415-frameworks-quarkus-mongodb

How do I install 415-frameworks-quarkus-mongodb in Claude Code?

Run npx skills add jabrena/plinth --skill 415-frameworks-quarkus-mongodb -a claude-code, then open ~/.claude/skills/415-frameworks-quarkus-mongodb/SKILL.md.

What does 415-frameworks-quarkus-mongodb do?

Provides examples and recommendations for MongoDB in Quarkus: Panache entity design, repositories, indexes, error handling, and transactions. Verifies that code compiles before and after changes.

What do I need to use this skill?

A Quarkus project with Maven and the ability to run ./mvnw compile and ./mvnw clean verify. The skill reads references/415-frameworks-quarkus-mongodb.md from the Plinth repository.

Source text

SKILL.md · Apache-2.0
---
name: 415-frameworks-quarkus-mongodb
description: Use when you need MongoDB persistence in Quarkus — including Panache Mongo entities/repositories, document design, indexes, transactions where applicable, and error handling. This should trigger for requests such as Add MongoDB in Quarkus; Review Quarkus Mongo Panache design; Improve Mongo error handling in Quarkus services; Model MongoDB documents for a Quarkus service; Configure Quarkus MongoDB clients codecs or transactions. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Quarkus — MongoDB

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

## Constraints

Compile before MongoDB 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 MongoDB in Quarkus
- Review Quarkus Mongo Panache entities/repositories
- Improve duplicate key handling, retry policy, or optimistic locking in Quarkus Mongo
- Model MongoDB documents for a Quarkus service
- Configure Quarkus MongoDB clients codecs or transactions

## Workflow

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

Read `references/415-frameworks-quarkus-mongodb.md` and inspect persistence setup before proposing changes.

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

Identify model/query consistency needs and define safe improvements.

3. **Apply framework-aligned changes**

Implement/refactor Panache Mongo mappings, repository access, 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/415-frameworks-quarkus-mongodb.md](references/415-frameworks-quarkus-mongodb.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 →
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 414-frameworks-quarkus-kafka 414-frameworks-quarkus-kafka guides Kafka messaging setups in Quarkus using SmallRye Reactive Messaging. Useful for channel tuning, serialization, and DLQ failure handling. 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 183-java-observability-tracing-opentelemetry 183-java-observability-tracing-opentelemetry guides OpenTelemetry distributed tracing setup in Java services with context propagation and semantic attributes. CX Codex +1 253installs

More in the catalog

Project sponsors

Companies that keep this analytics open