CtrlK
BlogDocsLog inGet started
Tessl Logo

java-coding-standards

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

64

Quality

55%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./docs/ja-JP/skills/java-coding-standards/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 identifies its domain (Java/Spring Boot coding standards) and lists relevant topic areas, but it reads more like a table of contents than an actionable skill description. It lacks concrete actions (what the skill does with these standards) and completely omits 'when to use' guidance, making it difficult for Claude to reliably select this skill from a large pool.

Suggestions

Add a 'Use when...' clause specifying triggers, e.g., 'Use when writing or reviewing Java code for Spring Boot projects, or when the user asks about Java coding conventions, naming standards, or project structure.'

Replace the category list with concrete actions, e.g., 'Enforces naming conventions, promotes immutability patterns, guides proper Optional and Stream API usage, and defines project layout for Spring Boot services.'

Include common English and Japanese trigger terms users might naturally use, such as 'code review', 'best practices', 'コードレビュー', 'ベストプラクティス', '.java files'.

DimensionReasoningScore

Specificity

The description names the domain (Java/Spring Boot) and lists several topic areas (naming, immutability, Optional usage, streams, exceptions, generics, project layout), but these are categories rather than concrete actions. It doesn't describe what the skill actually does with these topics (e.g., 'enforces', 'validates', 'applies').

2 / 3

Completeness

The description answers 'what' at a high level (Java coding standards for Spring Boot) but completely lacks any 'when should Claude use it' guidance. There is no 'Use when...' clause or equivalent explicit trigger guidance, which per the rubric should cap completeness at 2, and since the 'what' is also somewhat weak, a score of 1 is appropriate.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'Java', 'Spring Boot', 'コーディング標準' (coding standards), 'Optional', 'ストリーム' (streams), 'ジェネリクス' (generics). However, it misses common variations users might say such as 'code style', 'best practices', 'code review', 'conventions', and English equivalents that might be used in mixed-language contexts.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Java', 'Spring Boot', and 'コーディング標準' provides reasonable specificity, but it could overlap with general Java coding skills, Spring Boot development skills, or code review skills. The lack of explicit trigger conditions increases conflict risk.

2 / 3

Total

7

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-organized, concise coding standards skill that efficiently communicates Java/Spring Boot conventions through concrete examples and clear section headers. Its main weakness is that some sections lean toward descriptive guidance rather than fully executable examples, and the content could benefit from progressive disclosure by linking to deeper reference files for topics like testing and exception handling patterns.

Suggestions

Complete the generics example with a full method body instead of `{ ... }` to improve actionability

Consider extracting detailed topics (testing patterns, exception hierarchy examples, project structure) into separate reference files with clear links from the main skill

DimensionReasoningScore

Conciseness

The content is lean and efficient. It avoids explaining what Java, Spring Boot, or basic concepts are. Every section delivers concrete standards without padding. Comments in code examples are minimal and purposeful.

3 / 3

Actionability

Code examples are concrete and illustrative but many sections provide guidelines rather than executable patterns (e.g., 'avoid broad catch', 'keep methods short'). The generics example uses `{ ... }` instead of a complete implementation. Some sections like exceptions and code smells are descriptive rather than fully actionable.

2 / 3

Workflow Clarity

This is a coding standards skill, not a multi-step workflow. The single-purpose nature (define coding conventions) is clearly organized with unambiguous sections. No destructive or batch operations are involved, so validation checkpoints are not needed.

3 / 3

Progressive Disclosure

The content is well-structured with clear section headers, but it's a moderately long monolithic file (~100+ lines of content) with no references to external files for deeper topics like testing strategies, exception handling patterns, or project structure details. Some sections could benefit from being split out.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
affaan-m/everything-claude-code
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.