CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docker-patterns

Docker and Docker Compose patterns for local development, container security, networking, volume strategies, and multi-service orchestration.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/docker-patterns/SKILL.md

The canonical home for this skill is docker-patterns in affaan-m/ECC

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 strong, highly actionable reference: complete executable examples, lean code-first presentation, and good section organization with sensible safety flagging. The two gaps are the complete absence of progressive disclosure (all content in one long file, no referenced deep-dive files) and a missing explicit validation step after bringing up the stack.

DimensionReasoningScore

Conciseness

The body is code-dominant with terse inline comments ("# Bind mount for hot reload", "# Anonymous volume -- preserves container deps") and almost no explanation of concepts Claude already knows. It is not a 5 because of mild redundancy — the Volume Strategies section re-explains named/bind/anonymous volumes already demonstrated in the Compose example, and the Anti-Patterns section restates points made earlier (non-root, :latest, secrets).

4 / 5

Actionability

Nearly everything is copy-paste ready: a complete multi-service docker-compose.yml with healthchecks, a full multi-stage Dockerfile with non-root user, override/prod compose files with the exact up commands, concrete security settings, and commented debugging commands. Examples cover the common cases and are executable as written.

5 / 5

Workflow Clarity

This is a patterns/reference skill rather than a fragile multi-step workflow, and it is well organized: a 'When to Activate' trigger list, dependency ordering via `condition: service_healthy`, and the one destructive command (`docker compose down -v`) is explicitly flagged 'DESTRUCTIVE'. It falls short of 5 because there are no explicit validation/feedback loops (e.g. verifying the stack is healthy after `up`) where a light checkpoint would help.

4 / 5

Progressive Disclosure

Everything lives inline in a single ~365-line SKILL.md with no bundle files and no references to separate material; sections like Container Security, Debugging, and the full Compose examples are self-contained chunks that could plausibly live in one-level-deep reference files. Section headers and ordering are good, but there is no progressive disclosure at all — content that should arguably be split is inlined, matching the 3 anchor rather than the split-and-signaled 4/5 anchors.

3 / 5

Total

16

/

20

Passed

Description

66%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 specific, domain-clear description with good natural trigger terms and low conflict risk. Its main weakness is the missing 'Use when...' activation clause, which caps completeness at 3 and weakens trigger guidance despite the body containing a solid 'When to Activate' section that the description ignores.

Suggestions

Append an explicit trigger clause, e.g. "Use when setting up Docker Compose for local development, writing or reviewing Dockerfiles, or troubleshooting container networking, volumes, or multi-service setups."

Include common artifact names users mention naturally — "Dockerfile", "docker-compose.yml", ".dockerignore" — to broaden trigger-term coverage.

Convert one or two topic nouns into action verbs (e.g. "Reviews Dockerfiles for security and size" instead of "container security") to strengthen the 'what does this do' answer.

DimensionReasoningScore

Specificity

The description names the domain and enumerates five concrete coverage areas — "local development, container security, networking, volume strategies, and multi-service orchestration" — giving specific scope rather than vague claims. It falls short of 5 because it lists topic areas rather than concrete actions (no verb phrases like 'Reviews Dockerfiles' or 'Configures Compose stacks').

4 / 5

Completeness

The 'what' is clearly and concretely stated (Docker/Docker Compose patterns across five named areas), but there is no 'Use when...' clause or equivalent trigger guidance — the 'when' is entirely absent, which the guidelines say caps completeness at 3. It is a solid 3 rather than lower because the 'what' half is explicit and comprehensive.

3 / 5

Trigger Term Quality

Strong natural keywords users would actually say: "Docker", "Docker Compose", "local development", "container security", "networking", "volumes". Missing a few common variations and artifacts users mention, such as "Dockerfile", "docker-compose.yml", or ".yml", which keeps it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

"Docker and Docker Compose" carves out a clear, recognizable niche with distinct trigger terms, unlikely to fire for unrelated skills. Minor overlap risk remains with closely related skills (generic containerization, devops, or Kubernetes skills), keeping it below the minimal-conflict 5 anchor.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/docker-patterns/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.