CtrlK
BlogDocsLog inGet started
Tessl Logo

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; Model MongoDB documents for a Quarkus service; Configure Quarkus MongoDB clients codecs or transactions. Part of Plinth Toolkit

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

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

A well-structured, lean skill body that delegates detail correctly to a verified one-level reference and enforces compile/verify checkpoints around risky persistence changes. Weakest points are the somewhat abstract middle workflow steps and small textual redundancy between the constraints lead-in and its bullet list.

Suggestions

Tighten workflow steps 2–3 with concrete decision criteria (e.g., what signals indicate a repository vs. active-record choice, or which error-handling patterns to look for), since 'define safe improvements' is currently vague.

Add a short recovery instruction for verification failure (e.g., revert the change, re-inspect the failing test/stack trace, re-apply) to complete the feedback loop and close the workflow-clarity gap.

Drop the redundant lead sentence 'Compile before MongoDB refactors; verify after changes' — the MANDATORY/SAFETY/VERIFY bullets already state it.

DimensionReasoningScore

Conciseness

The body is lean with no explanation of concepts Claude already knows, but has minor duplication: the lead sentence "Compile before MongoDB refactors; verify after changes" restates the MANDATORY/VERIFY bullets, and the "When to use this skill" list repeats the description's triggers. Anchor 4 ("minor instances... that could be trimmed") fits; not 5 because those redundant lines don't each earn their place, and not 3 because there is no genuine over-explanation.

4 / 5

Actionability

Concrete, executable commands are present (`./mvnw compile` / `mvn compile`, `./mvnw clean verify` / `mvn clean verify`) along with an explicit reference path to read. But steps 2–3 of the workflow are abstract — "Identify model/query consistency needs and define safe improvements" — without criteria or examples of what a safe improvement looks like, matching anchor 4 (mostly executable with minor gaps) rather than 5.

4 / 5

Workflow Clarity

The four-step sequence is clear and gated by explicit validation checkpoints: compile MANDATORY before changes, "If compilation fails, stop immediately", and VERIFY after — a genuine feedback boundary for a database-touching refactor. It falls short of anchor 5 because there is no error-recovery loop (what to do on verify failure) and step 2 ("Gather scope and decide target improvements") is loosely defined; it exceeds anchor 3 because validation checkpoints are explicit, not implicit.

4 / 5

Progressive Disclosure

The body is a clean ~40-line overview (constraints, triggers, workflow) with a single, clearly signaled, one-level-deep reference — [references/415-frameworks-quarkus-mongodb.md](references/415-frameworks-quarkus-mongodb.md) — which exists on disk and contains the detailed rules and examples. No detail is inlined that belongs in the reference, and no nested references, matching anchor 5.

5 / 5

Total

17

/

20

Passed

Description

90%Weight 40%Scale 1-5

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

A strong description with explicit what/when coverage and natural, comprehensive trigger phrases. Its only notable weakness is second-person phrasing ("Use when you need") in a field that should use third-person voice, which costs it specificity per the rubric guideline.

Suggestions

Rewrite the opening in third person (e.g., "Provides MongoDB persistence guidance for Quarkus, covering Panache Mongo entities/repositories, document design, indexes, transactions, and error handling. Use when...") to remove the second-person voice penalized by the rubric.

Lead with verb-first concrete capabilities rather than a topic list, so the 'what' reads as actions ("Design Mongo documents, implement Panache repositories, configure codecs/transactions, handle duplicate-key errors") instead of a noun enumeration.

DimensionReasoningScore

Specificity

The description enumerates several concrete capability areas — "Panache Mongo entities/repositories, document design, indexes, transactions where applicable, and error handling" — plus action-oriented triggers ("Add", "Review", "Improve", "Model", "Configure"), which alone would fit anchor 4. However, the judging guideline penalizes second-person voice ("Use when you need MongoDB persistence in Quarkus") by reducing specificity by 1, landing at 3. It is not 2 because the domain and multiple concrete actions are clearly named, not generic.

3 / 5

Completeness

Both questions are answered explicitly: the "what" ("MongoDB persistence in Quarkus — including Panache Mongo entities/repositories, document design, indexes, transactions where applicable, and error handling") and the "when" ("Use when you need MongoDB persistence in Quarkus... This should trigger for requests such as..."). This mirrors the anchor-5 example structure with concrete trigger phrases.

5 / 5

Trigger Term Quality

Trigger phrases read exactly like natural user requests: "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". Coverage spans the domain's key nouns (MongoDB, Quarkus, Panache, codecs, transactions) and verb variations, matching the comprehensive anchor; this domain has no meaningful file extensions to include.

5 / 5

Distinctiveness Conflict Risk

The Quarkus + MongoDB + Panache pairing is a clear niche with distinct triggers, minimal overlap risk with generic database or Quarkus skills. "Part of Plinth Toolkit" hints at sibling skills, but every trigger term is qualified by both technologies, keeping conflict risk minimal.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
Reviewed

Table of Contents

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.