CtrlK
BlogDocsLog inGet started
Tessl Logo

creating-sbx-templates

Build a Docker Sandbox template image by extending docker/sandbox-templates. Use when writing a Dockerfile for sbx, choosing a base variant, building a family of templates with bake, or publishing and loading one with sbx template.

72

Quality

91%

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.

Highly actionable, well-structured content: executable code and commands throughout, a clear workflow order, and appropriate use of bundle files for the fuller Dockerfile and bake matrix. The minor gaps are the placement of time-sensitive date/version material and the absence of an explicit post-build verification checkpoint.

Suggestions

Condense or quarantine the date/version provenance in 'Last verified' so stale time-sensitive details don't compete for tokens (e.g., keep only the authoritative 'sbx --help' pointer).

Add one explicit post-build verification step, such as smoke-testing one variant (sbx run) before docker buildx bake --push publishes the family.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no basic Docker/bake concept explanations, and justifications are compressed to single lines ('One line ends the question'). Score 4 rather than 5 because time-sensitive material (dates 2026-08-07/08-10, buildx v0.36.0, VERSION pins in prose) sits in a 'Last verified' section rather than an old-patterns/deprecated section, and a couple of anecdotal asides ('four authors in the wild disagreed') could be trimmed.

4 / 5

Actionability

Guidance is fully executable: a complete annotated Dockerfile, copy-paste commands (docker buildx bake --list=targets, sbx run -t docker.io/you/my-template:v1, gh auth token | sbx secret set --registry ghcr.io --password-stdin, docker image save ... -o t.tar), and both linked bundle files (assets/Dockerfile, assets/docker-bake.hcl) exist. Common cases are covered by specific examples.

5 / 5

Workflow Clarity

Sections follow the real sequence (pick base → write Dockerfile → bake family → publish/run → save sandbox) and include a pre-build checkpoint ('--list=targets # the expansion, before building anything') plus failure-mode warnings (missing contexts entry silently resolving to the registry). Score 4 rather than 5 because there is no explicit post-build verification step (e.g., smoke-testing a sandbox before --push).

4 / 5

Progressive Disclosure

Well-organized overview with essentials inline and fuller material split into real, one-level-deep, clearly signaled asset references ('A fuller version is in [assets/Dockerfile]', 'the matrix form is in [assets/docker-bake.hcl]'), both verified to exist. Headers make navigation easy and nothing that belongs in a separate file is inlined.

5 / 5

Total

18

/

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 strong description: it states one clear capability, backs it with an explicit 'Use when' clause covering the main task scenarios, and uses the domain's natural vocabulary. The only improvement space is broader synonym coverage for image-building phrasing.

Suggestions

Consider adding natural synonyms such as 'custom sandbox image' or 'container image' to the trigger phrase list for broader keyword coverage.

Optionally mention the sibling boundary (run-time permissions belong to kits) in one clause to further reduce any overlap with a related sbx skill.

DimensionReasoningScore

Specificity

The description names the concrete primary action ('Build a Docker Sandbox template image by extending docker/sandbox-templates') and enumerates multiple specific sub-actions — 'writing a Dockerfile for sbx, choosing a base variant, building a family of templates with bake, or publishing and loading one with sbx template' — giving comprehensive coverage of the skill's domain. Score 5 rather than 4 because no concrete capability area is noticeably missing.

5 / 5

Completeness

It explicitly answers 'what' ('Build a Docker Sandbox template image by extending docker/sandbox-templates') and 'when' with a concrete 'Use when...' clause listing four trigger scenarios. This matches the anchor-5 example structure (clear what + explicit when with concrete trigger phrases).

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Dockerfile', 'sandbox', 'template', 'bake', 'sbx', 'publish', 'load' — terms a user with this need would plausibly say. Score 4 rather than 5 because a few natural synonyms users might use ('custom sandbox image', 'container image') are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — building sbx template images — and the triggers (Dockerfile for sbx, bake family, sbx template publish/load) are distinct from generic Docker work or run-time kit configuration, so conflict risk is minimal. Voice is imperative/third-person as in the good examples, with no vague fluff.

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.

Repository
slurpyb/sbx-agent
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.