CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/zipkin-trace-tests

Author integration tests that query Zipkin for trace verification - Zipkin all-in-one Docker for CI, REST API (`/api/v2/traces`, `/api/v2/services`, `/api/v2/dependencies`), B3 propagation header tests (single-header and multi-header X-B3-* form), dependency-graph assertions. Use when the team uses Zipkin (legacy or Spring Cloud Sleuth heritage).

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

Quality

Content

92%

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

A tight, actionable skill body with executable code at every step, a clear step sequence, and useful gotcha notes. Its main weakness is progressive disclosure: the large inline endpoint table and full test templates would benefit from being split into bundled reference files rather than living entirely in SKILL.md.

Suggestions

Move the /api/v2 endpoint table and full B3 header-format details into a references/ file (e.g. zipkin-api-reference.md), leaving SKILL.md as a lean overview that links out.

Extract the complete pytest templates (trace query, B3 propagation, dependency-graph) into scripts/ or a references/ examples file, keeping only a representative snippet plus a pointer inline.

Add a short 'Quick start' section at the top (docker run + one minimal trace assertion) so the fastest path is visible before the detailed per-step walkthrough.

DimensionReasoningScore

Conciseness

Lean and code-driven: docker commands, API tables, and executable Python tests with minimal prose. The one background line ("Zipkin is the original distributed-tracing system...") is brief, and the inline notes are non-obvious gotchas (string-typed tags, lazy dependency aggregation) rather than basic concepts. Not score 2 because there is little expendable explanation.

3 / 3

Actionability

Fully executable, copy-paste-ready guidance throughout: docker run command, GitHub Actions service block, SDK exporter setup, and complete pytest-style test functions with real endpoints and params. Not score 2 because the code is concrete and complete rather than pseudocode.

3 / 3

Workflow Clarity

Steps 1-7 are clearly sequenced (run Zipkin → query API → configure SDK → assert → B3 tests → dependency graph → isolation), with verification built into the test assertions and a dedicated anti-patterns table giving fixes. Not capped at 2 because the operations are non-destructive test flows that include explicit assertions/checkpoints rather than batch or destructive changes missing validation.

3 / 3

Progressive Disclosure

Well-organized into clear sections with one-level-deep external references ([Zipkin quickstart docs], [Zipkin API spec], [B3 propagation spec]), but the ~200-line body keeps the full API endpoint table and several complete test templates inline with no bundle files to split into. Not score 3 because for a skill this size, the endpoint reference and full test templates could live in reference files to keep the overview leaner; not score 1 because organization and navigation are clear and references are not deeply nested.

2 / 3

Total

11

/

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 written in third person that names concrete test activities, includes natural trigger terms, and gives an explicit use-when clause scoped to Zipkin/Spring Cloud Sleuth shops. No fluff or over-claims; distinct from the sibling Jaeger skill.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: "Author integration tests that query Zipkin", "B3 propagation header tests (single-header and multi-header X-B3-* form)", and "dependency-graph assertions", plus specific endpoints (/api/v2/traces, /api/v2/services, /api/v2/dependencies). Not score 2 because it goes beyond naming a domain to enumerating several distinct, concrete test activities.

3 / 3

Completeness

Explicitly answers both what (author B3 header tests, REST API trace queries, dependency-graph assertions) and when ("Use when the team uses Zipkin (legacy or Spring Cloud Sleuth heritage)"). Not score 2 because the trigger is explicit, not merely implied.

3 / 3

Trigger Term Quality

Contains natural terms the target audience would say — "Zipkin", "trace verification", "integration tests", and "Spring Cloud Sleuth heritage". Not score 2 because these cover the common variations a user would actually invoke rather than only jargon.

3 / 3

Distinctiveness Conflict Risk

Clear Zipkin-specific niche with B3 propagation and /api/v2 endpoints; the "Use when the team uses Zipkin" trigger and sister-skill mention distinguish it from the jaeger-trace-tests skill. Not score 2 because the triggers are specific enough to avoid overlapping with generic tracing skills.

3 / 3

Total

12

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents