415-frameworks-quarkus-mongodb

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. Part of cursor-rules-java project

Quality

88%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is well-structured and concise with a clear workflow and appropriate safety constraints for MongoDB refactoring operations. Its main weakness is the near-complete delegation of actionable content to the reference file — the SKILL.md itself contains no code examples, Panache patterns, or concrete MongoDB guidance, making it more of a process wrapper than a self-contained skill. Adding at least a minimal quick-start example would significantly improve actionability.

Suggestions

Add a brief inline code example showing a basic Panache Mongo entity and repository pattern so the skill has some immediately actionable content without requiring the reference file.

Include at least one concrete error handling example (e.g., duplicate key handling or optimistic locking pattern) to demonstrate the patterns mentioned in the 'When to use' section.

Dimension	Reasoning	Score
Conciseness	The skill is lean and efficient. It avoids explaining what MongoDB is, what Panache is, or how Quarkus works. Every section serves a purpose and there's no padding or unnecessary context.	3 / 3
Actionability	The skill provides concrete commands (./mvnw compile, mvn clean verify) and a clear workflow, but lacks any executable code examples for Panache Mongo entities, repositories, or error handling patterns. The actual actionable content is deferred entirely to the reference file.	2 / 3
Workflow Clarity	The workflow has a clear 4-step sequence with explicit validation checkpoints: compile before changes, stop on failure, verify after changes. The feedback loop (compilation fails → stop immediately) is well-defined for a potentially destructive refactoring operation.	3 / 3
Progressive Disclosure	The skill references a single detailed reference file at one level deep, which is good structure. However, since no bundle files were provided, we cannot verify the reference exists or assess its quality. The SKILL.md itself contains no inline examples or quick-start content, making it overly dependent on the reference file for all substantive guidance.	2 / 3
	Total	10 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly defines its scope (MongoDB persistence in Quarkus), lists specific capabilities, and provides explicit trigger guidance with example user requests. The description is well-structured with both a 'Use when' clause and concrete trigger examples, making it easy for Claude to select appropriately. Minor note: it uses second-person 'you' in the opening but this is within the 'Use when' clause which is a common pattern in the good examples.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: Panache Mongo entities/repositories, document design, indexes, transactions, and error handling. These are concrete, actionable capabilities rather than vague abstractions.	3 / 3
Completeness	Clearly answers both 'what' (MongoDB persistence with Panache entities/repositories, document design, indexes, transactions, error handling) and 'when' (explicit 'Use when' clause plus 'This should trigger for' with concrete example requests).	3 / 3
Trigger Term Quality	Includes strong natural keywords users would say: 'MongoDB', 'Quarkus', 'Panache Mongo', 'Mongo error handling', 'document design', 'indexes', 'transactions'. The example trigger phrases ('Add MongoDB in Quarkus', 'Review Quarkus Mongo Panache design') mirror realistic user requests.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive niche: MongoDB persistence specifically in Quarkus with Panache. The combination of framework (Quarkus), database (MongoDB), and library (Panache) creates a very clear, non-overlapping domain unlikely to conflict with other skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: jabrena/cursor-rules-java
Commit: dcf0eaa

Reviewed: about 1 hour ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.