CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docker-extend

Use when: User wants to extend Docker with custom tools, personalize the Docker environment, or set up user-specific Docker customization. Triggers: 'extend docker', 'docker-extend', 'add tools to docker', 'customize docker', 'add my tools to the container', 'personalize docker setup', 'docker user setup', 'install tools in docker'. Does: Interactively sets up Dockerfile.user and docker-compose.override.yml so users can add personal tools to their Docker environment without affecting maintainer files or committing user-specific config to git.

74

Quality

93%

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

90%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, lean single-file skill: concrete commands in every step, explicit mode detection with a fallback, and deliberate safety rails around overwriting files and auto-running rebuilds. The main gaps are the absence of a post-edit validation/feedback loop and some duplicated DEV/DEPLOY parallel blocks that pad the body.

Suggestions

Add a validation checkpoint after Step 4, e.g. "Show the modified RUN block and confirm the package names are valid apt packages before handing over the rebuild command" — a cheap verify-before-rebuild loop.

Consolidate the duplicated DEV_MODE/DEPLOY_MODE blocks (Steps 2, 3, 5) into a small mode-to-paths table so each step states the rule once instead of twice.

In Step 4, specify what to do when a tool is not available via apt-get (fail fast with the package name) so the agent does not silently produce a broken build.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows (no Docker/compose primer); every step is a command, a file snippet, or a direct instruction like "Use the Edit tool — do not rewrite the entire file". Lean and efficient with every token earning its place matches anchor 5; it is not 4 because there is no over-explanation to trim.

5 / 5

Actionability

Fully executable throughout: an inline context-detection bash command, conditional cp commands per mode, a concrete dockerfile RUN apt-get block with placeholders, and copy-paste rebuild commands per mode. Matches the copy-paste-ready anchor; it is not 4 because the guidance covers the common cases (both dev and deploy modes, missing/present files, arguments present/absent).

5 / 5

Workflow Clarity

A clear five-step sequence with mode branching, an explicit UNKNOWN_MODE fallback ("ask the user which directory their docker-compose.yml lives in"), and protective checkpoints ("Do NOT overwrite existing files", "Do NOT run it automatically"). Missing an explicit validation/feedback loop after editing Dockerfile.user (nothing verifies the edit or that the install succeeds), so it matches anchor 4 with minor validation gaps; it is not 5 because there is no validate-and-retry step, and not 3 because state checks in Step 2 and the conditional guards act as real checkpoints for the risky parts (overwriting files).

4 / 5

Progressive Disclosure

No bundle files exist, and the single-file structure with labeled Step sections and a Summary is appropriately contained for this scope. Good structure with minor organization gaps (duplicated DEV_MODE/DEPLOY_MODE parallel blocks inflate the body to ~93 lines) matches anchor 4; it is not 5 because the under-50-line simple-skill exception does not apply and the duplicated per-mode blocks could be tightened.

4 / 5

Total

18

/

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: third-person voice, explicit Use when/Triggers/Does structure, concrete file names, and clear side-effect boundaries. The only weakness is a few generic trigger phrases ('customize docker', 'docker user setup') that could collide with broader Docker setup skills.

Suggestions

Narrow the generic triggers ('customize docker', 'docker user setup') toward phrases that signal personal/user-scoped customization, e.g. 'add my own tools to docker', 'personal docker overlay', to reduce overlap with general Docker setup skills.

Optionally trim the trigger list to the 4-5 most natural phrases; beyond that, additional variants add length without adding distinctiveness.

DimensionReasoningScore

Specificity

"Interactively sets up Dockerfile.user and docker-compose.override.yml so users can add personal tools to their Docker environment without affecting maintainer files or committing user-specific config to git" names two concrete files, the concrete action, and the outcome with side-effect boundaries. This matches the anchor for multiple specific concrete actions with comprehensive coverage; it is not 4 because there are no minor gaps in what the skill does.

5 / 5

Completeness

Explicit "Use when:", "Triggers:", and "Does:" clauses clearly answer both what the skill does and when to use it, with concrete trigger phrases. This is the anchor case for answering both what AND when explicitly; it is not 4 because the when is not merely present but enumerated.

5 / 5

Trigger Term Quality

The explicit trigger list ('extend docker', 'add tools to docker', 'customize docker', 'add my tools to the container', 'personalize docker setup', 'docker user setup', 'install tools in docker') covers natural phrasing variants users would actually say. Comprehensive synonym coverage matches the top anchor; it is not 4 because both imperative and descriptive variants are present.

5 / 5

Distinctiveness Conflict Risk

The niche (gitignored personal Docker override files) is distinct, but generic triggers like 'customize docker' and 'docker user setup' could overlap with general Docker/compose setup skills. Mostly distinct with minor overlap risk matches anchor 4; it is not 5 because those generic phrases leave non-minimal conflict surface with sibling Docker skills, and not 3 because the file-level triggers (Dockerfile.user, docker-compose.override.yml) anchor it firmly.

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

coleam00/Archon

Path

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