CtrlK
BlogDocsLog inGet started
Tessl Logo

java-coding-standards

Spring Bootサービス向けのJavaコーディング標準:命名、不変性、Optional使用、ストリーム、例外、ジェネリクス、プロジェクトレイアウト。

60

Quality

70%

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 ./docs/ja-JP/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 tight, well-organized Java/Spring Boot coding-standards reference with concrete, mostly-executable code examples and no unnecessary concept explanations. Its main limitation is that several example snippets are partial placeholders rather than fully copy-paste-ready.

Suggestions

Make code examples fully executable by replacing `{ ... }` and empty method bodies with minimal complete implementations or explicit 'body omitted' annotations.

Consider splitting the longer reference sections (プロジェクト構造, テストの期待) into one-level-deep reference files linked from SKILL.md to strengthen progressive disclosure.

Tighten the '核となる原則' section to avoid restating principles that are illustrated concretely in later sections.

DimensionReasoningScore

Conciseness

The body is lean: short PASS/FAIL code blocks and terse bullets, with no padding explaining what Java or Spring Boot is, assuming Claude's competence. It is not 5 because the '核となる原則' section restates principles that recur in later sections, a minor instance of over-explanation that could be trimmed.

4 / 5

Actionability

Examples are concrete, real Java (record definitions, Optional.map/orElseThrow, stream pipelines, bounded-generics indexById), giving mostly executable guidance. It is not 5 because several snippets are intentionally partial (empty method bodies like `findBySlug(String slug) {}` and `{ ... }` placeholders), leaving minor gaps.

4 / 5

Workflow Clarity

As a single-purpose reference skill the 'action' (apply these standards) is unambiguous and the sections are well-organized, qualifying for the simple-skill exception; no destructive or batch workflow is present so the cap at 3 does not apply. It is not 5 because there is no sequenced process or validation checkpoint, only topical organization.

4 / 5

Progressive Disclosure

The content is well-structured with clear section headers and no nested or buried references, and no external files are needed. It is not 5 because the body exceeds the ~50-line simple-skill threshold and several sections (e.g. project structure, test expectations) could optionally 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 clearly states what the skill covers and enumerates concrete topic areas, but it omits any explicit 'Use when...' trigger guidance, which caps its completeness. Trigger terms and distinctiveness are solid for the Spring Boot Java niche.

Suggestions

Add an explicit trigger clause, e.g. 'Use when writing or reviewing Java code for Spring Boot services, or when the user asks about Java coding conventions, naming, or project layout.'

Include a few natural synonyms users might say (e.g. 'コード規約', 'コーディング規約', 'Spring Boot conventions') to broaden trigger coverage.

Reframe the topic list slightly toward actions (e.g. '命名の適用', 'Optionalの活用') to push specificity toward 5.

DimensionReasoningScore

Specificity

Names the domain ('Spring Bootサービス向けのJavaコーディング標準') and lists several concrete coverage areas (命名、不変性、Optional使用、ストリーム、例外、ジェネリクス、プロジェクトレイアウト), giving broad but topic-level rather than action-level coverage. It sits above 3 (which requires only 1–2 concrete actions) but the items are topical areas rather than the explicit concrete actions a 5 demands.

4 / 5

Completeness

The 'what' is clear (Java coding standards for Spring Boot services with enumerated topics), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is not 2 because the 'what' is concrete and specific rather than vague.

3 / 5

Trigger Term Quality

Natural terms a user would say are present ('Spring Boot', 'Java', 'コーディング標準', 'ストリーム', 'ジェネリクス'), giving good keyword coverage. It is below 5 because common synonymous phrasings users might say (e.g. 'コード規約', 'レビュー', 'Spring Boot conventions') are not covered.

4 / 5

Distinctiveness Conflict Risk

The 'Spring Bootサービス向け' framing carves a clear niche distinct from generic Java or language-agnostic skills, with minor overlap risk against broader Java coding-standards skills. It is not 5 because the topic list (naming, exceptions, generics) overlaps with general Java style guides.

4 / 5

Total

15

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
affaan-m/ECC
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.