CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

common-observability

Enforce structured JSON logging, OpenTelemetry distributed tracing, and RED metrics across backend services. Use when adding request correlation, setting up tracing spans, defining SLO burn-rate alerts, or instrumenting middleware.

Quality

88%

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

86%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 lean, well-structured standards document with concrete, specific guidance, an explicit validation step in its workflow, and clean one-level-deep references that actually exist. The minor gaps — no inline compliant log-event example and no error-recovery guidance when verification fails — keep actionability and workflow clarity just below the top anchors.

DimensionReasoningScore

Conciseness

The body is entirely lean, imperative standards — 'Always emit JSON structured logs', 'Propagate W3C traceparent', 'Alert on SLO burn rates, not raw threshold spikes' — with no explanation of concepts Claude already knows and no padding. Every token earns its place, matching the top anchor.

5 / 5

Actionability

Guidance is concrete and specific — exact headers ('X-Request-Id or traceparent'), a span-naming pattern with example ('GET /users/:id'), named libraries ('pino', 'zap'), required metrics with percentiles (p50/p95/p99) — with executable code deferred to references/implementation.md. It stops short of a 5 because an inline example of a compliant structured log event or metric naming is absent (those specifics live only in the reference files).

4 / 5

Workflow Clarity

The 'Instrumentation Workflow' is a clear 5-step sequence that ends with an explicit verification checkpoint ('Exercise a success and failure path; confirm spans close and IDs join logs to traces'). It does not reach a 5 because there is no error-recovery feedback loop telling Claude what to do when the verification fails (e.g., spans not closing or IDs not joining).

4 / 5

Progressive Disclosure

The body is a short, well-organized overview with standards inline and detail split into two real, one-level-deep references — [implementation examples](references/implementation.md) (Pino logger setup) and [Observability Data Formats](references/observability-formats.md) (log schema, metric naming) — both of which exist and contain substantive content. This matches the anchor for a clear overview with well-signaled, easy-to-navigate references.

5 / 5

Total

18

/

20

Passed

Description

88%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 in third person that clearly states what the skill enforces and when to use it, with concrete, natural trigger phrases covering the observability domain. The only weaknesses are a few missing common synonyms (e.g., monitoring, alerting) and minor overlap risk with adjacent single-concern skills.

DimensionReasoningScore

Specificity

"Enforce structured JSON logging, OpenTelemetry distributed tracing, and RED metrics" lists multiple concrete actions that comprehensively cover the observability triad (logs, traces, metrics). It matches the anchor for multiple specific concrete actions with comprehensive coverage; a 4 would require minor gaps in coverage, but the three pillars are all named.

5 / 5

Completeness

The description explicitly answers both questions: what ('Enforce structured JSON logging, OpenTelemetry distributed tracing, and RED metrics across backend services') and when ('Use when adding request correlation, setting up tracing spans, defining SLO burn-rate alerts, or instrumenting middleware') with concrete trigger phrases. This directly matches the top anchor; a 4 would need a less explicit or less specific 'when' clause.

5 / 5

Trigger Term Quality

The 'when' clause offers natural phrases users would say — 'adding request correlation', 'setting up tracing spans', 'defining SLO burn-rate alerts', 'instrumenting middleware' — plus terms like logging, metrics, and OpenTelemetry. It falls short of a 5 because common variations such as 'monitoring', 'alerting', or 'instrumentation' in general are absent.

4 / 5

Distinctiveness Conflict Risk

The observability niche (structured logging, tracing, RED metrics, SLO burn-rate alerts) is mostly distinct with unambiguous triggers. It sits at 4 rather than 5 because phrases like 'instrumenting middleware' and 'SLO alerts' carry minor overlap risk with a dedicated alerting/monitoring or middleware skill in a larger library.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

.agents/skills/common/common-observability/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.