CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

martinfrancois/java-streams

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

2.77x
Quality

100%

Does it follow best practices?

Impact

100%

2.77x

Average score across 3 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.

An unusually disciplined skill body: dense, project-specific rules with no basic-concept padding, executable pattern snippets for the common cases, a numbered workflow with explicit checkpoints and a fix-and-rescan feedback loop, and a clean three-file reference split that is one level deep and well signaled. The telegraphic, rule-dense prose occasionally demands a careful read, but nothing is missing, padded, or misplaced.

DimensionReasoningScore

Conciseness

No basic Java or stream concepts are explained; every rule is skill-specific and non-obvious ('Do not swap split("\\R") for String.lines(), which recognizes fewer line terminators', 'no CompletableFuture fan-out', 'Carry element + result, never null sentinels'). The telegraphic style keeps every token load-bearing, matching anchor 5 ('lean and efficient; assumes Claude's competence') rather than anchor 4, since no over-explained passage could be trimmed without losing a rule.

5 / 5

Actionability

Fully concrete and executable: a goal-to-API decision table ('Exactly one match, duplicates must fail' -> 'filter(...).limit(2).toList(), then a switch on the size'), complete Java snippets (the limit(2)+switch unique-match idiom, the Gatherers.mapConcurrent example, toMap with merge function SeatIndex::later), and a concrete verification scan. Specific examples cover the common cases, matching anchor 5; not anchor 4, since nothing is pseudocode or missing key details.

5 / 5

Workflow Clarity

Steps 0-7 are clearly sequenced (baseline check -> terminal choice -> implementation -> prompt constraints -> verification) with an explicit mid-flow 'Checkpoint: before writing the chain, confirm the chosen terminal returns the requested type' and a feedback loop at the end: 'Run the marker scan from hard-stops.md... fix hits, and re-scan', plus a verification checklist ('empty inputs, one element, duplicates, nulls, ordering, and baseline compatibility'). This matches anchor 5's validate -> fix -> retry pattern; not anchor 4, because validation checkpoints are explicit and looped rather than minor-gapped.

5 / 5

Progressive Disclosure

The body stays an overview of workflow rules while worked examples, antipattern detail, and version compatibility are split into three one-level-deep references (references/hard-stops.md, references/stream-examples.md, references/java-stream-api.md — all verified to exist on disk), each surfaced via a purpose table ('Replacement antipatterns and the marker scan to run') and contextual inline links ('Run the marker scan from hard-stops.md'). This matches anchor 5's clear overview with well-signaled one-level-deep references; no nesting or buried references exist.

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.

A dense, information-rich description that names concrete capabilities (review, clean up mutation, write/refactor) and pairs them with an explicit 'Use whenever' trigger clause covering comprehensive natural terminology from method-level API names to review-prompt phrasings. Its only weakness is length — nearly 200 words in a single paragraph — but every clause carries a concrete capability or trigger, so it reads as comprehensive rather than padded.

DimensionReasoningScore

Specificity

Concrete actions are named throughout — 'Review Java stream performance advice... clean up mutation and write or refactor Java Stream and Collector code' — plus an enumerated antipattern list ('materializing just to inspect, sorting before min/max, counting for existence, nested stream collections, unsafe null sorting, multi-line lambdas'). This is multiple specific concrete actions with comprehensive coverage, matching the anchor-5 example; it is not anchor 4 because no capability area of the domain is left uncovered, and not below because nothing is generic filler.

5 / 5

Completeness

The 'what' is explicit ('Review... clean up mutation and write or refactor Java Stream and Collector code. Avoid common stream antipatterns...') and the 'when' is an explicit trigger clause with concrete phrases: 'Use whenever a Java task writes, reviews, or refactors Stream API code (map, filter, flatMap, reduce, collect) or a collector'. Both questions are clearly and explicitly answered, exactly the anchor-5 pattern; not anchor 4 because the trigger guidance is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Natural terms a user would actually say appear comprehensively: 'parallelStream', 'findFirst or findAny', 'map, filter, flatMap, reduce, collect', 'grouping collectors', 'joining strings', 'sorted/limit/distinct stages', 'primitive stream totals', 'Optional values inside streams'. Coverage includes synonyms and variations ('Stream API code', 'parallel streams', 'stream first/any element lookup'), matching anchor 5 rather than anchor 4 where natural terms would be missing.

5 / 5

Distinctiveness Conflict Risk

The niche is the Java Stream API specifically, with distinct triggers unlikely to fire for a wrong skill: 'whether a lookup should use findFirst or findAny, lookups that must fail on duplicates, regex splitting inside a stream chain, result mutability, and stream chain layout'. A general Java or code-review skill would not claim these stream-specific API terms, so conflict risk is minimal per anchor 5; anchor 4 would require identifiable overlap with a closely related skill, which is absent.

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