CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

java-coding-standards

Java coding standards for Spring Boot services: naming, immutability, Optional usage, streams, exceptions, generics, and project layout.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/java-coding-standards/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-organized, lean standards reference: concrete code examples for each convention area, clear activation criteria, and no concept over-teaching beyond a few basic naming reminders. It falls just short of top marks on actionability (stub snippets) and progressive disclosure (monolithic single-file layout at ~140 lines).

Suggestions

Replace stub snippets with complete executable examples, e.g. give indexById a full method body and show a real builder/DTO fix under 'Code Smells to Avoid' instead of 'use DTO/builders' with no example.

Trim or collapse the universally-known naming basics (PascalCase/camelCase/UPPER_SNAKE_CASE) into a single line, keeping only project-specific conventions.

Consider moving extended pattern guidance (e.g. full Optional/stream/exception catalogs) into a one-level-deep references/ file, keeping SKILL.md as a concise overview.

DimensionReasoningScore

Conciseness

Sections like '## Optional Usage' and '## Streams Best Practices' deliver short code blocks with one-line comments and no padded prose — every section adds project-specific convention rather than filler. Matches anchor 4 ('efficient; minor instances of over-explanation'), not 5, because a few snippets re-teach basics Claude already knows (e.g. '✅ Classes/Records: PascalCase', '✅ Constants: UPPER_SNAKE_CASE') that could be trimmed.

4 / 5

Actionability

Quotes: 'return market.map(MarketResponse::from).orElseThrow(() -> new EntityNotFoundException("Market not found"));' and 'throw new MarketNotFoundException(slug);' — concrete, idiomatic patterns for most sections. Matches anchor 4 ('mostly executable guidance; concrete code with minor gaps'), not 5, because some snippets are stubs rather than copy-paste ready ('public class MarketService {}', 'indexById(Collection<T> items) { ... }').

4 / 5

Workflow Clarity

This is a single-purpose standards skill with no multi-step process and no destructive or batch operations, so no validation loop is required; the '## When to Activate' section makes the single task unambiguous. It scores 4 rather than 5 because at ~140 lines it exceeds the under-50-lines simple-skill exception, and sections like 'Code Smells to Avoid' give direction without showing how to apply the fix ('use DTO/builders' shows no builder example).

4 / 5

Progressive Disclosure

The body is a self-contained ~3.8KB document with 12 clearly headed sections (Naming, Immutability, Optional Usage, ...) and no nested or broken references (no references/, scripts/, or assets/ files exist, and none are cited). Matches anchor 4 ('good structure; most content appropriately placed; minor organization gaps'), not 5, because at over 50 lines with several deep-dive topics (Optional, streams, exceptions), some detail could be split into one-level-deep reference files.

4 / 5

Total

16

/

20

Passed

Description

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

The description is specific and distinctive, naming a clear domain and seven concrete topic areas in third-person voice with no fluff. Its main weakness is the absence of any 'Use when...' trigger clause, which caps completeness and leaves activation conditions implicit.

Suggestions

Append an explicit trigger clause, e.g. 'Use when writing, reviewing, or refactoring Java code in Spring Boot projects, or when the user mentions Java conventions, code style, or Spring Boot services.'

Add natural synonyms users might say, such as 'Java conventions', 'code style', 'code review', or '.java files', to broaden trigger coverage.

Mention the additional areas the body actually covers (logging, null handling, testing, formatting) so the description's coverage matches the skill's scope.

DimensionReasoningScore

Specificity

Quotes: "naming, immutability, Optional usage, streams, exceptions, generics, and project layout" — seven concrete topic areas named after a clear domain ("Java coding standards for Spring Boot services"). Matches anchor 4 ('lists several specific actions; minor gaps') rather than 5 because it enumerates topics rather than comprehensive actions and omits areas the body covers (logging, testing, formatting).

4 / 5

Completeness

The 'what' is clear ("Java coding standards for Spring Boot services: naming, immutability, Optional usage...") but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3; not 4 because 'when' is entirely absent, not merely implicit.

3 / 5

Trigger Term Quality

Quotes: "Java coding standards", "Spring Boot", "Optional usage", "streams", "naming", "exceptions" — natural phrases users would say when needing this skill. Not 3 (coverage is good, not just 'some relevant keywords') and not 5 because common variations like "code review", "Java conventions", "code style", or ".java" are missing.

4 / 5

Distinctiveness Conflict Risk

Quotes: "Java coding standards for Spring Boot services" — a clear niche (Java + Spring Boot + enumerated topics) that is unlikely to trigger for non-Java or non-standards skills. Matches anchor 4 ('mostly distinct; minor overlap risk'), with only slight overlap risk against a generic Java style or general code-review skill; not 5 because no explicit trigger phrases further separate it.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/java-coding-standards/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.