CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

181-java-observability-logging

Use when you need to implement or improve Java logging and observability — including selecting SLF4J with Logback/Log4j2, applying proper log levels (ERROR, WARN, INFO, DEBUG, TRACE), parameterized logging, correlation context, secure logging without sensitive data exposure, environment-specific configuration, log aggregation, monitoring, and alerting. This should trigger for requests such as Improve logging; Apply logging; Refactor logging; Add logging support; Review SLF4J structured logging in Java code. Part of Plinth Toolkit

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured orchestrator skill: clear compile-first workflow with explicit validation gates, and excellent progressive disclosure delegating detail to a real, one-level-deep reference. The primary weakness is redundancy — the Constraints, Workflow, 'What is covered', and 'When to use' sections repeat the same commands and triggers two to three times.

Suggestions

Merge the Constraints section into the Workflow steps (fold 'MANDATORY: run ./mvnw compile' into step 1 and 'VERIFY: run ./mvnw clean verify' into step 4) so each command appears once.

Cut the 'When to use this skill' section — it duplicates the frontmatter description's trigger list verbatim and adds nothing for a reader already inside the skill.

Replace the 'What is covered in this Skill?' bullet list with the single-sentence overview plus the reference link, and move the bullet topics into the reference file's existing table of contents.

DimensionReasoningScore

Conciseness

The body is short and explains nothing Claude already knows, but it repeats itself: the Constraints section ('Run `./mvnw compile`... stop immediately', 'Run `./mvnw clean verify`') restates Workflow steps 1 and 4 verbatim, the 'What is covered in this Skill?' bullets restate the opening sentence, and 'When to use this skill' duplicates the description's trigger list. Mostly efficient with unnecessary duplication that could be tightened — matching anchor 3, not 2 (no concept over-explanation or padded prose) and not 4 (the redundancy spans three sections).

3 / 5

Actionability

Quotes: 'Run `./mvnw compile` or `mvn compile`', 'Read `references/181-java-observability-logging.md`', 'Run `./mvnw clean verify` or `mvn clean verify`' — concrete, executable commands plus a specific reference path to defer detailed guidance to (appropriate delegation). Not a 5 because the body gives no inline example of an actual logging improvement (e.g., a good/bad parameterized-logging snippet), so the first concrete logging action lives entirely in the bundled file; not a 3 because the orchestration steps themselves are fully executable.

4 / 5

Workflow Clarity

The four-step workflow (compile → read reference/assess → apply → verify) has explicit validation checkpoints with feedback loops: 'stop immediately if compilation fails' and 'stop immediately — do not proceed until resolved' plus a final full-build verification. This mirrors the anchor-5 example (validate → fix → only proceed when valid), so the destructive/batch cap at 3 does not apply since validation is present.

5 / 5

Progressive Disclosure

The body is a lean overview with a single, well-signaled, one-level-deep reference: 'For detailed guidance, examples, and constraints, see [references/181-java-observability-logging.md](references/181-java-observability-logging.md)' plus a dedicated workflow step for reading it. The bundle check confirms the referenced file exists and is internally organized (Examples 1-6, Output Format, Safeguards) with no further nesting. Matches the anchor-5 structure exactly.

5 / 5

Total

17

/

20

Passed

Description

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

A strong description that explicitly states what the skill does and when to use it, with concrete trigger phrases and Java-specific anchoring that minimizes conflict risk. The main deductions are the second-person phrasing ('Use when you need to'), penalized per the judging guidelines, and a handful of missing natural trigger variations.

DimensionReasoningScore

Specificity

Quotes: 'selecting SLF4J with Logback/Log4j2, applying proper log levels (ERROR, WARN, INFO, DEBUG, TRACE), parameterized logging, correlation context, secure logging without sensitive data exposure, environment-specific configuration, log aggregation, monitoring, and alerting' — a comprehensive list of concrete actions matching the anchor-5 example. However, the description uses second-person voice ('Use when you need to implement'), which the judging guidelines explicitly penalize by reducing specificity by 1, capping this at 4. It is not a 3 because the action coverage is far more comprehensive than '1-2 concrete actions'.

4 / 5

Completeness

Quotes: 'Use when you need to implement or improve Java logging and observability...' (explicit what + when) and 'This should trigger for requests such as Improve logging; Apply logging; Refactor logging...' (concrete trigger phrases). Both 'what' and 'when' are explicitly and concretely answered, matching the anchor-5 example exactly; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Quotes: 'This should trigger for requests such as Improve logging; Apply logging; Refactor logging; Add logging support; Review SLF4J structured logging in Java code' — natural phrases users would say, plus domain keywords (SLF4J, Logback, log levels). Not a 5 because a few natural variations are missing (e.g., 'set up logging', 'mask sensitive data in logs', 'log configuration'); not a 3 because coverage goes well beyond 'some relevant keywords' and includes multiple phrasings users would naturally use.

4 / 5

Distinctiveness Conflict Risk

Quotes: 'Java logging and observability', 'SLF4J with Logback/Log4j2', 'Review SLF4J structured logging in Java code' — a clear niche anchored to Java-specific frameworks, distinguishable from generic logging or monitoring skills. 'Part of Plinth Toolkit' adds provenance. Minimal conflict risk; not a 4 because the Java/SLF4J anchors make overlap with non-Java logging skills unlikely.

5 / 5

Total

18

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jabrena/plinth

Path

skills/181-java-observability-logging/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.