CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

depot-container-builds

Configures and runs Depot remote container builds using `depot build` and `depot bake`. Use when building Docker images, creating Dockerfiles with Depot, pushing images to registries, building multi-platform/multi-arch images (linux/amd64, linux/arm64), debugging container build failures, optimizing Dockerfile layer caching, using docker-bake.hcl or docker-compose builds, or migrating from `docker build` / `docker buildx build` to Depot. Also use when the user mentions depot build, depot bake, container builds, image builds, or asks about Depot's build cache, build parallelism, build autoscaling, or ephemeral registry.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 highly actionable, information-dense command reference with copy-paste-ready examples and well-chosen, Depot-specific content that assumes Claude's competence. Its main weaknesses are the 272-line monolithic structure with specialized sections (Registry, output formats, pricing) inlined instead of split into reference files, and minor redundancy (the gha cache warning appears twice).

Suggestions

Move the specialized Depot Registry section (pull-through cache configuration, token scoping, pull-token/push commands) into a references/registry.md file and keep a short overview with common `--save`/`depot pull` commands in SKILL.md.

Move the special output formats (estargz, zstd, SOCI) into a references/output-formats.md file, keeping only a one-line pointer plus the most common case inline.

Deduplicate the `--cache-from type=gha` / `--cache-to type=gha` guidance, which appears both in the Migration section and the Common Mistakes table — state it once and cross-reference it.

DimensionReasoningScore

Conciseness

The body is dense with executable commands and Depot-specific facts Claude would not know (builder pricing, autoscaling behavior, registry subdomains), with almost no explanation of familiar concepts. Minor trimmable redundancy remains: the `--cache-from type=gha` warning appears both in the Migration section and again in the Common Mistakes table, and the Registry prose (pull-through cache details, token scoping) runs long — so it sits at "efficient with minor over-explanation" rather than "every token earns its place".

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `depot build -t repo/image:tag . --push`, a complete HCL bake file example, per-service compose YAML, and error-specific fixes such as `DOCKER_API_VERSION=1.52 depot build --load .` and `--provenance=false` for unknown/unknown. Specific examples cover the common cases (build, load, push, save, multi-platform, secrets, migration).

5 / 5

Workflow Clarity

Sequences are clear where they matter — compose integration ("depot bake -f docker-compose.yml --load" then "docker compose up") and the migration steps — and verification signals exist (`--lint`, `--print`, "look for [depot] prefix in logs", `depot image list --output json`). It falls short of a 5 because there are no explicit validate-then-proceed feedback loops, though the skill is a command reference rather than a fragile multi-step pipeline, so the missing-loop cap for destructive/batch operations does not apply.

4 / 5

Progressive Disclosure

The body is a well-sectioned 272-line monolith with no bundle files and no references: specialized content that clearly belongs in separate reference files — the ~40-line Depot Registry section (pull-through cache, token scopes), special output formats (estargz/zstd/SOCI), and the pricing/autoscaling details — is inlined in SKILL.md. This matches the 3 anchor ("content that should be separate is inline"); the under-50-line simple-skill exception does not apply at this length, and it is not a 4 because there are no references at all to be "mostly clear".

3 / 5

Total

16

/

20

Passed

Description

96%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 that clearly states what the skill does and when to use it, with comprehensive, natural trigger terms including synonyms and file names. The only weakness is that broad triggers like "building Docker images" could pull this skill in for generic (non-Depot) Docker build requests, creating minor overlap with general Docker tooling skills.

Suggestions

Qualify the broadest triggers so they only fire for Depot-intended work, e.g. "building Docker images with Depot" instead of bare "building Docker images", to reduce conflict with generic Docker build skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Configures and runs Depot remote container builds", "pushing images to registries", "building multi-platform/multi-arch images", "debugging container build failures", "optimizing Dockerfile layer caching", "migrating from `docker build`" — with comprehensive coverage of build, push, multi-platform, debug, cache, bake, and migration use cases. No minor gaps in action coverage that would justify a 4.

5 / 5

Completeness

Explicitly answers both questions: the "what" ("Configures and runs Depot remote container builds using `depot build` and `depot bake`") and the "when" via two explicit trigger clauses ("Use when building Docker images..." and "Also use when the user mentions depot build, depot bake...") with concrete trigger phrases. Third-person voice throughout, so no voice penalty applies.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms ("multi-platform/multi-arch", "container builds, image builds", "docker build / docker buildx build") and file names ("docker-bake.hcl", "docker-compose"), plus product-specific phrases users would say ("depot build", "build cache", "build autoscaling", "ephemeral registry").

5 / 5

Distinctiveness Conflict Risk

Clear Depot niche with distinct branded triggers ("depot build", "depot bake", "ephemeral registry"), but the unqualified triggers "building Docker images" and "creating Dockerfiles" can fire on generic Docker build requests where Depot isn't intended — minor overlap risk with closely related Docker/build skills. Not a 5 because conflict risk is more than minimal; not a 3 because the bulk of triggers are unambiguously Depot-specific.

4 / 5

Total

19

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

PostHog/posthog

Path

.agents/skills/depot-container-builds/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.