CtrlK
BlogDocsLog inGet started
Tessl Logo

123-java-exception-handling

Use when you need to apply Java exception handling best practices — including using specific exception types, managing resources with try-with-resources, securing exception messages, preserving error context via exception chaining, validating inputs early with fail-fast principles, handling thread interruption correctly, documenting exceptions with @throws, enforcing logging policy, translating exceptions at API boundaries, managing retries and idempotency, enforcing timeouts, attaching suppressed exceptions, and propagating failures in async/reactive code. This should trigger for requests such as Exception handling; Use try-with-resources in Java code; Create exception chaining in Java code; Apply fail-fast validation in Java code. Part of cursor-rules-java project

88

Quality

85%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that thoroughly enumerates specific Java exception handling capabilities, includes natural trigger terms users would use, and explicitly states both what the skill does and when it should be triggered. The description is comprehensive and distinctive, though it is quite verbose — it could be slightly more concise without losing effectiveness.

DimensionReasoningScore

Specificity

The description lists numerous specific concrete actions: using specific exception types, managing resources with try-with-resources, securing exception messages, preserving error context via exception chaining, validating inputs with fail-fast principles, handling thread interruption, documenting with @throws, enforcing logging policy, translating exceptions at API boundaries, managing retries and idempotency, enforcing timeouts, attaching suppressed exceptions, and propagating failures in async/reactive code.

3 / 3

Completeness

The description clearly answers both 'what' (a comprehensive list of Java exception handling best practices) and 'when' ('Use when you need to apply Java exception handling best practices' plus explicit trigger examples like 'This should trigger for requests such as...'). The 'Use when' clause is present and explicit.

3 / 3

Trigger Term Quality

Includes many natural keywords users would say: 'exception handling', 'try-with-resources', 'exception chaining', 'fail-fast validation', 'Java code', '@throws', 'retries', 'timeouts', 'async/reactive'. The explicit trigger examples ('Use try-with-resources in Java code', 'Create exception chaining in Java code') further strengthen keyword coverage.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to Java exception handling best practices, a clear niche. The detailed enumeration of specific techniques (try-with-resources, exception chaining, fail-fast, suppressed exceptions, async/reactive propagation) makes it very unlikely to conflict with other skills, even other Java-related skills.

3 / 3

Total

12

/

12

Passed

Implementation

70%

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-structured skill with excellent workflow clarity and progressive disclosure — it clearly sequences the steps, includes compilation checkpoints, and appropriately defers detailed patterns to a reference file. Its main weakness is that the body itself contains no concrete code examples, making it less immediately actionable, and the bullet-point coverage list adds moderate verbosity without proportional value.

Suggestions

Add 1-2 inline code examples of the most common patterns (e.g., try-with-resources before/after, exception chaining) so Claude can act immediately without reading the reference file for simple cases.

Trim the 'What is covered' bullet list to 5-6 key items or replace it with a single sentence pointing to the reference, since the detailed list duplicates what the reference contains.

DimensionReasoningScore

Conciseness

The 'What is covered' bullet list is essentially a table of contents that restates what the reference file covers — this is moderately useful for discovery but adds ~15 lines that Claude doesn't strictly need. The constraints and workflow sections are lean and useful, but the introductory summary could be tighter.

2 / 3

Actionability

The skill provides concrete commands (mvnw compile, mvn clean verify) and a clear reference path, but contains zero executable code examples in the body itself. All actual patterns (good/bad code) are deferred to the reference file, so Claude must read another file before it can act on any specific exception handling pattern.

2 / 3

Workflow Clarity

The workflow is clearly sequenced with four numbered steps, includes explicit validation checkpoints (compile before changes, full verify after), and has a clear stop condition if compilation fails. This is a well-structured feedback loop for a potentially destructive refactoring operation.

3 / 3

Progressive Disclosure

The skill provides a concise overview with a single, clearly signaled one-level-deep reference to the detailed guide (references/123-java-exception-handling.md). The body appropriately keeps the workflow and constraints inline while deferring detailed examples to the reference file.

3 / 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
jabrena/cursor-rules-java
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.