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