CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/docker-compose-tests

Use when tests need the app plus several real services (database, cache, queue) started together. Writes a compose.test.yaml with healthcheck-ordered startup, per-job project names for parallel CI, --wait and --exit-code-from gating, and clean teardown with volumes removed.

Quality

92%

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 exemplary instructional skill: complete executable artifacts at every step, readiness validation wired into the orchestration itself, deterministic teardown, and reference material correctly split into two small, well-signaled bundle files. The only improvement space is token efficiency — a few repeated cross-references and one restated basic could be trimmed.

DimensionReasoningScore

Conciseness

The body is dense and assumes Compose competence — no tutorial padding, and the bulk of tokens are complete, usable code. Minor over-explanation remains: the pointer to references/compose-flags.md is repeated in Steps 2, 5, and 6, and Step 6 restates basics Claude knows ("down stops and removes containers and networks"), fitting "efficient; minor instances of over-explanation that could be trimmed" rather than level 5's every-token-earns-its-place.

4 / 5

Actionability

Fully executable, copy-paste-ready throughout: a complete compose.test.yaml with healthchecks and depends_on conditions, a full GitHub Actions workflow with matrix-sharded project names, both CI shapes as concrete bash with exit-code propagation, a migrations service example, and a profile example. Specific examples cover the common cases, matching the level-5 anchor.

5 / 5

Workflow Clarity

A clear 7-step sequence with explicit validation checkpoints at every stage: healthcheck gating (service_healthy), the db-healthy → migrate-exits-0 → app-starts chain via service_completed_successfully, --wait/--wait-timeout readiness gating with a bounded budget, exit-code propagation as the build verdict, and error-resilient teardown (if: always() / trap-on-EXIT). The one destructive operation (volume removal) is deliberately gated and always cleaned up, and failure modes are cataloged in the referenced anti-patterns file.

5 / 5

Progressive Disclosure

Verified against the actual bundle: two real reference files (compose-flags.md, anti-patterns.md), both one level deep, clearly signaled at the point of need ("The three depends_on conditions are tabulated in references/compose-flags.md") plus a closing References section, while the workflow itself stays inline in the main file. Matches "clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation".

5 / 5

Total

19

/

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 with an explicit "Use when" trigger clause and a highly concrete, flag-level capability list that mirrors the skill's actual steps. The main gaps are the absent natural trigger phrases ("docker compose", "integration tests") and some residual overlap risk with a hypothetical testcontainers/CI-setup skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Writes a compose.test.yaml with healthcheck-ordered startup, per-job project names for parallel CI, --wait and --exit-code-from gating, and clean teardown with volumes removed" — naming actual flags and covering the skill's core operations comprehensively. It exceeds the level-4 anchor ("minor gaps in coverage") because the actions named map to every major step of the skill.

5 / 5

Completeness

Both questions are answered explicitly: "Use when tests need the app plus several real services (database, cache, queue) started together" is a concrete trigger clause, and the what is a specific multi-part capability list. Not level 4, because the when-clause is explicit and specific rather than vague.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "tests", "app plus several real services", "database, cache, queue", "parallel CI", "teardown". However the phrases a user would most naturally say — "docker compose", "Compose", "integration tests" — never appear as trigger words ("compose" surfaces only inside the filename "compose.test.yaml"), matching "good keyword coverage; a few natural terms missing" rather than the comprehensive synonym coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

The niche (multi-service Compose orchestration for test stacks, with specific gating flags) is mostly distinct, but the trigger phrasing "app plus several real services ... started together" could also fire for a testcontainers-style or general CI-setup skill — the body itself names testcontainers as the neighboring alternative. Minor overlap risk with closely related skills, matching level 4; level 5's "minimal conflict risk" is not fully earned.

4 / 5

Total

18

/

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

On this page