CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/jaeger-trace-tests

Author integration tests that query a tracing backend for cross-service trace verification - Jaeger, Zipkin, or Grafana Tempo, same run-query-assert workflow. Jaeger all-in-one Docker for CI (OTLP gRPC :4317 + HTTP :4318 ingest, query API on :16686), `/api/traces?service=X&operation=Y` query patterns, span set + parent-child + duration assertions; Zipkin (:9411 REST API, B3 single/multi-header propagation tests, dependency graph) in references/zipkin.md; Tempo (TraceQL span selectors + structural operators, /api/search, single-binary Docker) in references/tempo.md. Use when verifying that a request produces the expected spans across service boundaries in a running Jaeger, Zipkin, or Tempo backend.

75

Quality

94%

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

Overview
Quality
Evals
Security
Files

Quality

Content

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

An excellent content body: copy-paste-ready commands and code for every step, an explicit flush-before-query checkpoint with anti-pattern recovery guidance, and a clean overview-to-references split verified against the actual bundle files. The only meaningful improvement is trimming minor duplication and treating the pinned image version as a maintenance note.

DimensionReasoningScore

Conciseness

Sections are lean and code-focused with almost no explanation of concepts Claude already knows, but minor trims exist: the quoted Jaeger-docs line in the intro, port details repeated between the How-to-use list and Step 1, and the pinned `jaeger:2.17.0` image tag is time-sensitive (partially mitigated by the Limitations note to verify the tag). Not 5 because of these instances; not 3 because nothing is padded and every section earns its place.

4 / 5

Actionability

Fully executable guidance: copy-paste-ready `docker run` command with a port table, a complete SDK wiring snippet, and a worked test showing the exact query params ("service", "operation", "lookback", "limit") and response JSON shape ("data", "spans", "operationName", "tags", key/value). Not 4 because every Jaeger-facing step is fully specified; the only placeholders (`use_tracer()`, `create_order(items=[item])`) are inherently app-specific.

5 / 5

Workflow Clarity

A five-step How-to-use sequence maps to labeled sections, the critical async checkpoint is made explicit and mandatory ("The `force_flush` + brief sleep is mandatory"), isolation scoping is specified ("unique service.name per test"), and the Anti-patterns table pairs each failure mode ("Query Jaeger immediately after exercise", "Skip flushing pipeline") with its fix. Not 4 because validation checkpoints and error-recovery guidance are explicit rather than implicit; this is a read-only, non-destructive workflow so no validation cap applies.

5 / 5

Progressive Disclosure

SKILL.md is a genuine overview: the core run-query-assert workflow stays inline while the full port map/CI wiring, advanced assertions, and the Zipkin and Tempo variants each live in one-level-deep reference files that exist in the bundle and are clearly signaled with their content (e.g., "TraceQL span selectors with structural operators… see references/tempo.md"). Not 4 because every reference is well-signaled, nothing that belongs in a reference is inlined, and the References section enumerates each file with a one-line scope.

5 / 5

Total

19

/

20

Passed

Description

92%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 highly effective description: explicit what-and-when structure, concrete capability list, and product-named triggers make routing unambiguous. Its one weakness is length — implementation details like port numbers and endpoint paths belong in the body, though none of it is fluff. Third-person voice is maintained throughout.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions — "Author integration tests that query a tracing backend for cross-service trace verification", "`/api/traces?service=X&operation=Y` query patterns", "span set + parent-child + duration assertions", "B3 single/multi-header propagation tests" — covering all three backends comprehensively. Not 4 because there are no gaps in action coverage; every capability the skill supports is named.

5 / 5

Completeness

Explicitly answers both: the "what" lists concrete capabilities (authoring trace-verification tests, query patterns, assertion types per backend) and the "when" is a concrete trigger clause — "Use when verifying that a request produces the expected spans across service boundaries in a running Jaeger, Zipkin, or Tempo backend". Not 4 because the "when" is specific and fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Good natural keywords users would say: "integration tests", "Jaeger", "Zipkin", "Grafana Tempo", "tracing backend", "spans", "cross-service". Not 5 because a few common variations are missing — "OpenTelemetry" and the exact phrase "distributed tracing" — and some keyword surface is deep jargon (port numbers, "OTLP gRPC :4317") users rarely say; not 3 because the product names and "integration tests" are exactly the natural triggers.

4 / 5

Distinctiveness Conflict Risk

Clear niche — authoring integration tests that query a tracing backend — with three named products (Jaeger, Zipkin, Grafana Tempo) as distinct triggers; a request mentioning any of them unambiguously routes here. Not 4 because the product names plus the query-API focus leave minimal overlap risk with adjacent skills.

5 / 5

Total

19

/

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.

Reviewed

Table of Contents