Spring Bootサービス向けのJavaコーディング標準:命名、不変性、Optional使用、ストリーム、例外、ジェネリクス、プロジェクトレイアウト。
64
55%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./docs/ja-JP/skills/java-coding-standards/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
5df943e
Table of Contents
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.