CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

logging-patterns

Java logging best practices with SLF4J, structured logging (JSON), and MDC for request tracing. Includes AI-friendly log formats for AI coding assistant debugging. Use when user asks about logging, debugging application flow, or analyzing logs.

Quality

82%

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

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

Highly actionable and concrete — every setup path yields copy-paste-ready config or code, and the skill enforces clear defaults (JSON everywhere, human-logs only for local dev). The main costs are token efficiency (basic SLF4J tutorials and duplicated JSON/profile setup sections) and a monolithic structure where the legacy-setup material should live in a separate reference file.

Suggestions

Move the 'Setup for Spring Boot < 3.4 (Legacy)' section (pom.xml dependency + full logback-spring.xml) into a references/ file and link to it from SKILL.md, keeping the main skill focused on the current Boot 4.x path.

Trim the SLF4J basics Claude already knows — the parameterized-logging good/bad concatenation examples and basic exception-as-last-argument guidance can collapse to one-line reminders in the Quick Reference table.

Deduplicate the JSON setup and human-logs profile switching, which currently appear in 'Recommended Setup for AI-Assisted Development', 'Quick Setup (Spring Boot 4.x)', and 'Profile-Based Switching' — consolidate into a single setup section.

DimensionReasoningScore

Conciseness

The body teaches SLF4J basics Claude already knows (parameterized logging "{}" vs string concatenation, passing exceptions as last argument) and repeats the JSON setup and human-logs profile switching across multiple sections ("Recommended Setup", "Quick Setup", "Profile-Based Switching", legacy XML). Mostly efficient prescriptive content, but it could be tightened by cutting the basic good/bad logging examples and the duplication. Not 2 because most sections add genuinely project-specific guidance (JSON-default rule, MDC propagation with virtual threads, what not to log).

3 / 5

Actionability

Fully executable throughout: complete application.yml configs, a full logback-spring.xml, the pom.xml dependency, copy-paste Java code (MDC filter, TaskDecorator, fluent API), jq commands for log analysis, and a quick-reference table. Specific examples cover the common cases for both Spring Boot 4.x and legacy setups.

5 / 5

Workflow Clarity

Decision paths are clear: the JSON-default rule is stated up front, setup is branched by Boot version (4.x native vs <3.4 logstash encoder), and profile switching includes concrete run commands. Not 5 because adoption is implicit — there is no sequenced "apply config, then verify JSON output" checkpoint, though the skill is prescriptive rather than a risky multi-step workflow, so the gap is minor.

4 / 5

Progressive Disclosure

A single ~450-line file with well-organized section headers but no bundle files at all; content that clearly belongs in a separate reference (the legacy Spring Boot <3.4 setup with full logback-spring.xml and pom snippet) is inlined in the main skill. Good headers and a Quick Reference keep it above anchor 2's "minimal structure", but it is not an overview pointing to one-level-deep reference files.

3 / 5

Total

15

/

20

Passed

Description

83%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 concrete capabilities (SLF4J, structured JSON logging, MDC, request tracing, AI-friendly formats) and includes an explicit "Use when..." clause with natural trigger phrases. The main gaps are minor: a few missing trigger synonyms and a slightly broad "debugging" trigger that could overlap with general debugging skills.

DimensionReasoningScore

Specificity

Names the Java logging domain with concrete technologies (SLF4J, structured JSON, MDC) and several specific actions (request tracing, AI-friendly log formatting, debugging). Falls between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive action coverage) — the technology names add specificity, but the framing is topic-listing rather than action-listing, so not 5.

4 / 5

Completeness

Explicitly answers both "what" ("Java logging best practices with SLF4J, structured logging (JSON), and MDC for request tracing... AI-friendly log formats") and "when" ("Use when user asks about logging, debugging application flow, or analyzing logs") with concrete trigger phrases, matching the anchor-5 pattern. Not below 5 since neither half is vague or implicit.

5 / 5

Trigger Term Quality

"Use when user asks about logging, debugging application flow, or analyzing logs" provides natural trigger phrases a user would actually say. Not 5 because common variations are missing (e.g., "troubleshooting", "add logs", "log levels", or library names like logback users might mention).

4 / 5

Distinctiveness Conflict Risk

The Java/SLF4J/MDC niche is mostly distinct with minor overlap risk against general debugging or observability skills. Not 5 because the broad "debugging application flow" trigger could fire for non-logging debugging requests; not 3 because the technology anchors keep it clearly distinguishable.

4 / 5

Total

17

/

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

piomin/claude-ai-spring-boot

Path

skills/logging-patterns/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.