CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

315-frameworks-spring-mongodb

Use when you need to design or implement MongoDB data access in Spring Boot — including document modeling, Spring Data Mongo repositories/templates, indexing, optimistic concurrency, and error handling. This should trigger for requests such as Add MongoDB in Spring Boot; Review Spring Data Mongo design; Improve error handling for Mongo writes; Model MongoDB documents for a Spring Boot service; Configure Spring Data MongoDB indexes or transactions. Part of Plinth Toolkit

71

Quality

89%

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

86%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 lean, well-structured overview body that respects token budget, directs all detail to a real one-level-deep reference, and includes compile/verify safety checkpoints around changes. The gaps are minor: implementation guidance in the body stays abstract, and the failure path halts instead of looping back to fix and retry.

Suggestions

Replace the "If compilation fails, stop immediately" halt with an explicit recovery loop (e.g., "If compilation fails, fix the errors and re-run compile before proceeding") to add the error-recovery feedback loop the rubric expects for database-related workflows.

Add one short inline representative snippet (e.g., a repository interface or @Document mapping) in the body so the highest-value implementation detail is visible before jumping to the reference.

DimensionReasoningScore

Conciseness

The ~40-line body explains nothing Claude already knows and defers all detail to the reference; every section (Constraints, When to use, Workflow, Reference) carries operational content, matching the lean anchor-5 profile. It is not anchor 4 because the only near-redundancy (the one-line "Compile before MongoDB refactors; verify after changes" preview of the bullets) is a navigation aid, not over-explanation.

5 / 5

Actionability

Concrete commands are present ("Run `./mvnw compile` or `mvn compile`", "Run `./mvnw clean verify` or `mvn clean verify`") plus a real, verifiable file path, but the core implementation steps stay high-level ("Implement/refactor mappings, repositories, indexes, and failure handling policies") with specifics deferred entirely to the reference — the anchor-4 case of mostly executable guidance with minor gaps, since the referenced file does supply the executable examples.

4 / 5

Workflow Clarity

The four-step sequence is clearly ordered with genuine checkpoints (compile before changes, stop on failure, verify after), placing it above anchor 3. It falls short of anchor 5 because "If compilation fails, stop immediately" is a halt rather than a validate→fix→retry feedback loop, and for a database-access refactor skill the rubric specifically rewards error-recovery loops.

4 / 5

Progressive Disclosure

The body is a clean overview that points to exactly one reference — `references/315-frameworks-spring-mongodb.md` — which exists in the bundle, is clearly signaled both in Workflow step 1 and a dedicated Reference section, and itself contains no nested references (verified: only well-organized sections and examples), matching the anchor-5 one-level-deep structure.

5 / 5

Total

18

/

20

Passed

Description

87%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 structure, natural trigger phrases, and a well-scoped niche. Its only flaws are the second-person "you need" phrasing (a voice violation that costs a specificity point) and slightly incomplete synonym coverage.

Suggestions

Rewrite the opening in third person or imperative voice (e.g., "Use when designing or implementing MongoDB data access in Spring Boot") to remove the second-person "you need" clause.

Add one or two natural synonyms users might say, such as "NoSQL data access" or "Mongo persistence", to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capability areas — "document modeling, Spring Data Mongo repositories/templates, indexing, optimistic concurrency, and error handling" — which matches the anchor-5 comprehensive example, but it opens with the second-person clause "Use when you need to design or implement", which the judging guidelines penalize by reducing specificity by 1.

4 / 5

Completeness

It explicitly answers both questions: the 'what' via the concrete capability list and the 'when' via "Use when you need to design or implement MongoDB data access in Spring Boot" plus "This should trigger for requests such as...", matching the anchor-5 example that pairs a what-statement with concrete trigger phrases.

5 / 5

Trigger Term Quality

Trigger phrases are natural and well-varied ("Add MongoDB in Spring Boot", "Review Spring Data Mongo design", "Model MongoDB documents for a Spring Boot service", "Configure Spring Data MongoDB indexes or transactions"), but common synonyms such as "NoSQL" or general persistence wording are absent, so it is good-not-comprehensive coverage per the anchor-4 example.

4 / 5

Distinctiveness Conflict Risk

The MongoDB-in-Spring-Boot niche is tightly scoped with distinct triggers (Spring Data Mongo, Mongo writes, MongoDB documents) that would not fire for unrelated skills; this is a clear niche with minimal conflict risk. It is not the anchor-4 case because the trigger phrases name the specific technology pair rather than a broader overlapping category.

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

Path

skills/315-frameworks-spring-mongodb/SKILL.md

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.