CtrlK
BlogDocsLog inGet started
Tessl Logo

182-java-observability-metrics-micrometer

Use when you need to implement or improve Java metrics observability with Micrometer — including meter design, naming/tag conventions, cardinality control, timers/counters/gauges/distribution summaries, percentiles/histograms, Actuator/Prometheus integration, and metrics validation through tests. This should trigger for requests such as Improve metrics; Apply Micrometer; Add metrics observability; Refactor Micrometer instrumentation; Add Micrometer timers counters or gauges to Java services. Part of Plinth Toolkit

69

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

70%

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

A well-structured overview with a clear sequenced workflow and good one-level-deep progressive disclosure. It is held back by redundancy across the intro/covered/scope/when sections and by a lack of inline executable instrumentation examples, which are deferred to the reference.

Suggestions

Remove redundancy: the opening paragraph restates the "What is covered in this Skill?" bullets and the Workflow intent — consolidate or cut the overlapping intro/Scope text to tighten the body.

Add one small inline executable Micrometer example (e.g., a Counter or Timer registration with a low-cardinality tag) so the body is actionable without forcing a reference read for basic instrumentation.

Drop or shrink the "When to use this skill" section, which duplicates the trigger terms already in the description frontmatter.

DimensionReasoningScore

Conciseness

The body is lean and avoids explaining basics Claude already knows, but the intro paragraph, the "What is covered in this Skill?" bullets, the Scope line, and the "When to use this skill" list overlap each other and duplicate the description; it could be tightened. Not score 3 because of this redundancy, not score 1 because nothing is padded with concept explanations.

2 / 3

Actionability

Provides some concrete guidance — the VERIFY command "`./mvnw clean verify` or `mvn clean verify`", a meter-type-to-behavior mapping, and named bad tag values (userId, UUID, raw URL) — but no executable Micrometer meter-instrumentation code examples, with the good/bad examples deferred to the reference. Not score 1 because concrete commands and rules exist; not score 3 because nothing is copy-paste ready instrumentation.

2 / 3

Workflow Clarity

A clear 4-step sequence (Define goals → Select meter types → Harden → Validate) with an explicit validation checkpoint in step 4 reinforced by the VERIFY constraint and the mvn command. Not score 2 because the checkpoint is explicit rather than implicit; metrics instrumentation is not a destructive/batch operation that would cap the score at 2 for a missing retry loop.

3 / 3

Progressive Disclosure

A concise overview SKILL.md (~50 lines) with well-organized sections pointing via a clearly signaled markdown link to the verified one-level-deep file references/182-java-observability-metrics-micrometer.md (462 lines, no further nesting). Not score 2 because the reference is clearly signaled and the split is appropriate.

3 / 3

Total

10

/

12

Passed

Description

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.

A strong, specific description with explicit trigger guidance and a clearly bounded niche. It answers what the skill does and when to invoke it without resorting to vague fluff.

DimensionReasoningScore

Specificity

Lists multiple specific concrete capabilities — "meter design, naming/tag conventions, cardinality control, timers/counters/gauges/distribution summaries, percentiles/histograms, Actuator/Prometheus integration, and metrics validation through tests" — matching the score-3 anchor; it is not score 2 because the actions are comprehensive rather than a partial domain mention.

3 / 3

Completeness

Clearly answers both what (the capability list) and when via the explicit "Use when you need to implement or improve Java metrics observability..." clause plus a trigger list; the present 'Use when' clause avoids the score-2 cap.

3 / 3

Trigger Term Quality

"Improve metrics; Apply Micrometer; Add metrics observability; Refactor Micrometer instrumentation; Add Micrometer timers counters or gauges to Java services" are natural phrasings a user would actually say, with good coverage; not score 2 because common variations are present rather than sparse.

3 / 3

Distinctiveness Conflict Risk

"Java metrics observability with Micrometer" pins a specific language, library, and domain, giving a clear niche unlikely to conflict with other skills; not score 2 because the scope is narrow, not merely 'somewhat specific'.

3 / 3

Total

12

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
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.