CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

martinfrancois/java-optionals

Help AI coding agents use Java Optional well in new code, review, and cleanup without replacing one antipattern with another.

100

2.08x
Quality

100%

Does it follow best practices?

Impact

100%

2.08x

Average score across 7 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

100%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 tight, high-signal skill body: it encodes project-specific Optional rules (Java baseline gating, checked-IO boundaries, review-scope honesty, marker scan) without any tutorial padding, backs each rule with executable Java, and sequences the work with explicit first/last ordering and a re-scan feedback loop. Navigation to the three reference files is clean and one level deep. The only nit is an orphaned "Flatten `Stream<Optional<T>>`" sentence in step 3 that belongs with stream guidance, which is too minor to move it off the level-5 anchors.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows — it is entirely prescriptive rules and compact before/after snippets ("Start nullable input with `Optional.ofNullable(...)`; don't reopen the value with `get()`"), with aphoristic decision rules like "One Optional, one terminal." every token earns its place.

5 / 5

Actionability

Complete Java examples cover the common cases — guard/read replaced with "`cart.map(this::summarize).orElseGet(() -> createSummary(cartId))`", flatMap chains, the checked-IO empty-guard shape, and "`return new LegacyTicket(id, note.orElse(null))`" at a legacy boundary — and the referenced hard-stops.md contains an executable `rg -n` marker scan.

5 / 5

Workflow Clarity

Steps 0–8 have explicit ordering constraints ("Check the Java baseline before choosing APIs", "Check last, with hard-stops.md") and a closing validation step with a feedback loop: "Run focused tests or trace present/absent/fallback cases... Run the marker scan... fix relevant hits and re-scan." The hard-stops antipattern list acts as a checklist, matching the level-5 anchor's validate-fix-retry loop.

5 / 5

Progressive Disclosure

The Reference Bundle table maps each of the three real files to a purpose (all verified present), references are one level deep and well-signaled with inline links (hard-stops.md in steps/scan, java-optional-api.md in step 4), and the split is appropriate: core rules and a few key examples inline, bulk examples (711 lines) and API compatibility delegated.

5 / 5

Total

20

/

20

Passed

Description

100%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.

An exemplary description: third-person, information-dense rather than padded, with a complete what/when pair and method-name trigger terms that are both natural and unique to this skill's niche. Every clause either states a concrete capability or a concrete trigger, so nothing reads as fluff despite the length. No dimension falls below its level-5 anchor.

DimensionReasoningScore

Specificity

"Write, review, and refactor Java Optional code" plus named API bindings ("map, flatMap, orElseGet, or ifPresentOrElse"), laziness of fallback work, findFirst/findAny order contracts, and named rejections ("orElse(null) workarounds, and fake one-Optional collections") give multiple concrete actions with comprehensive coverage — no gaps that would justify the level-4 anchor.

5 / 5

Completeness

Both halves are explicit: a full "what" (write/review/refactor with the binding and rejection rules) and an explicit "Use whenever..." clause with three concrete trigger conditions, matching the level-5 anchor's example structure exactly.

5 / 5

Trigger Term Quality

The trigger list — "isPresent/isEmpty, get/orElseThrow, orElse(null), optional.stream(), findFirst/findAny, checked exceptions inside Optional chains, or nullable control flow" — is exactly what a user would naturally say, and synonyms are covered ("a nullable return, a missing value, or a fallback default").

5 / 5

Distinctiveness Conflict Risk

The niche is Java's Optional specifically, with method-level triggers that no adjacent skill (general Java review, streams, null handling) would claim; overlap risk is minimal, fitting "clear niche with distinct triggers".

5 / 5

Total

20

/

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.

Reviewed

On this page