416-frameworks-quarkus-mongodb-migrations-mongock — Quarkus skill
416-frameworks-quarkus-mongodb-migrations-mongock — a skill for setting up and verifying MongoDB migrations in Quarkus via Mongock. Adds @ChangeUnit classes, configures the quarkus-mongock extension, and validates migration order.
Apache-2.0 212 installs ★ 465 updated 2026-10-21
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-codeWhat 416-frameworks-quarkus-mongodb-migrations-mongock does
The skill covers the full Mongock workflow in Quarkus: connecting the Quarkiverse quarkus-mongock extension, configuring quarkus.mongock.*, writing idempotent @ChangeUnit migrations with @Execution hooks and rollback logic. It includes rules for locks, transactions, and constraints on the default MongoDB client.
Before any change, the skill compiles via ./mvnw compile or mvn compile, then runs ./mvnw clean verify or mvn clean verify after applying changes. If compilation fails, the skill stops. Before adding the extension, it verifies the latest Quarkiverse Mongock release against the active Quarkus platform and MongoDB client version.
The skill also handles coordination with @415-frameworks-quarkus-mongodb and edge cases such as multiple MongoDB clients in the application.
What it helps with
- add Mongock migrations to a Quarkus application
- configure quarkus-mongock and automatic migration execution at startup
- create and order @ChangeUnit classes with rollback support
- verify idempotency and lock safety in migrations
- test migrations using Quarkus tests with Dev Services
Example prompts for the agent
- Add a Mongock migration to alter the users collection schema in Quarkus
- Create a @ChangeUnit to fix data in the orders collection with rollback logic
- Verify migration order and quarkus-mongock compatibility with the current Quarkus platform
How to install 416-frameworks-quarkus-mongodb-migrations-mongock
1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code2Manually: put the files in place
~/.claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/
1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a codex2Manually: put the files in place
.agents/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a cursor2Manually: put the files in place
.cursor/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/416-frameworks-quarkus-mongodb-migrations-mongock2Manually: put the files in place
.github/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.md1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a gemini-cli2Platform CLI
gemini skills install https://github.com/jabrena/plinth --path skills/416-frameworks-quarkus-mongodb-migrations-mongockManually: put the files in place
.devin/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -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 416-frameworks-quarkus-mongodb-migrations-mongock
How do I install 416-frameworks-quarkus-mongodb-migrations-mongock in Claude Code?
Run npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code, then open ~/.claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.md.
What does this skill do?
The skill adds and reviews MongoDB migrations via Mongock in Quarkus, configures the extension, writes @ChangeUnit classes, checks compatibility, and verifies via tests.
What validation does the skill perform before making changes?
The skill requires compilation before any change, verifies Quarkiverse Mongock compatibility with the active Quarkus version, and detects conflicts with multiple MongoDB clients.
Source text
SKILL.md · Apache-2.0
--- name: 416-frameworks-quarkus-mongodb-migrations-mongock description: Use when you need to add or review Mongock MongoDB data migrations in a Quarkus application — including the Quarkiverse Mongock extension, Quarkus MongoDB client configuration, migrate-at-start, @ChangeUnit classes, lock/transaction settings, and Quarkus test verification. This should trigger for requests such as Add Mongock migrations in Quarkus; Configure quarkus-mongock; Review Quarkus MongoDB data migrations; Create Mongock change units for Quarkus MongoDB; Review Mongock migration ordering in a Quarkus service. Part of Plinth Toolkit license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.19.0 --- # Quarkus - MongoDB migrations (Mongock) Apply Mongock migration guidelines for Quarkus and Quarkus MongoDB client/Panache Mongo. **What is covered in this Skill?** - Quarkiverse `quarkus-mongock` extension and Quarkus MongoDB client setup - `quarkus.mongock.*` configuration, including `migrate-at-start` - Code-first `@ChangeUnit` migrations with `@Execution` and rollback hooks - Locking, idempotency, transaction limits, and default-client constraints - Quarkus tests with Dev Services or Testcontainers MongoDB - Coordination with `@415-frameworks-quarkus-mongodb` **Scope:** Apply recommendations based on the reference rules and good/bad examples. ## Constraints Compile before Mongock or MongoDB migration changes; 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 good/bad patterns - **EXTENSION COMPATIBILITY**: Before adding `quarkus-mongock`, verify the latest Quarkiverse Mongock release and Quarkus extension catalog compatibility with the active Quarkus platform. If the latest extension targets a significantly older Quarkus version, stop and document the incompatibility instead of applying changes. - **EDGE CASE**: If the application uses multiple MongoDB clients, verify Quarkiverse Mongock support before applying a default-client migration design ## When to use this skill - Add Mongock migrations in Quarkus - Configure quarkus-mongock - Review Quarkus MongoDB data migrations - Create Mongock change units for Quarkus MongoDB - Review Mongock migration ordering in a Quarkus service ## Workflow 1. **Read references and inspect MongoDB setup** Read `references/416-frameworks-quarkus-mongodb-migrations-mongock.md`, `references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md`, and `references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md`, then inspect `pom.xml`, Quarkus MongoDB configuration, and existing `@415-frameworks-quarkus-mongodb` persistence patterns. 2. **Verify extension compatibility and execution policy** Verify the Quarkiverse `quarkus-mongock` release and Quarkus extension catalog compatibility before configuring MongoDB connection settings, migration scan behavior, and startup vs explicit `MongockFactory` execution. 3. **Apply framework-aligned migrations** Implement/refactor `@ChangeUnit` classes with idempotent operations, explicit ordering, rollback hooks, and safe lock/transaction settings. 4. **Run verification and report results** Execute build/tests, including Quarkus tests with Dev Services or Testcontainers MongoDB where feasible, and summarize outcomes and follow-up risks. ## Reference For detailed guidance, examples, and constraints, see: - [references/416-frameworks-quarkus-mongodb-migrations-mongock.md](references/416-frameworks-quarkus-mongodb-migrations-mongock.md) - [references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md](references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md) - [references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md](references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md)
© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth