CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/devops-essentials

DevOps essentials — Dockerfile best practices, CI/CD patterns, deployment configuration, and container security

89

1.21x
Quality

87%

Does it follow best practices?

Impact

100%

1.21x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

92%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description with excellent specificity and comprehensive trigger coverage. It clearly articulates both capabilities and usage triggers. The main weakness is its broad scope which could cause conflicts with more specialized DevOps-related skills, and the prescriptive 'MUST' language is slightly unusual for a skill description.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'multi-stage Dockerfiles with non-root users', 'proper .dockerignore files', 'cache-efficient layer ordering', 'health checks', 'CI/CD pipelines with separate build/test/deploy stages', '12-factor configuration', 'graceful shutdown handling', and 'secrets management'.

3 / 3

Completeness

Clearly answers both what (DevOps best practices including Docker, CI/CD, configuration, etc.) AND when ('Apply this whenever creating Dockerfiles, docker-compose configurations, CI/CD pipelines, or deploying any application').

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'Dockerfiles', 'docker-compose', 'CI/CD pipelines', 'deploying', 'environment variables', 'secrets management', 'health checks'. These are terms developers naturally use when discussing DevOps tasks.

3 / 3

Distinctiveness Conflict Risk

While focused on DevOps/Docker/CI-CD, the broad scope ('every production-bound application') and overlap with general deployment, configuration, or containerization skills creates some conflict risk. Could trigger alongside more specific Docker-only or CI/CD-only skills.

2 / 3

Total

11

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a comprehensive, highly actionable DevOps skill with excellent concrete examples in multiple languages. The WRONG/RIGHT pattern effectively teaches best practices, and the checklist provides clear validation. However, the document is verbose with some explanations Claude doesn't need, and the length suggests content could be better distributed across reference files.

Suggestions

Remove explanatory text that Claude already knows (e.g., 'A container escape with root access compromises the host', 'Docker caches each layer') - just show the pattern

Consider splitting language-specific examples (Python vs Node.js) into separate reference files to reduce main document length

Tighten the WRONG examples - a brief comment explaining the issue is sufficient without the preceding paragraph

DimensionReasoningScore

Conciseness

The skill contains some unnecessary explanations (e.g., explaining why containers run as root by default, what happens during container escape) that Claude already knows. The WRONG/RIGHT pattern is useful but adds verbosity; some sections could be tightened.

2 / 3

Actionability

Excellent executable examples throughout - complete Dockerfiles, CI/CD YAML, TypeScript/Python code snippets that are copy-paste ready. Every concept has concrete, working code examples for both Node.js and Python.

3 / 3

Workflow Clarity

Clear checklist at the end provides explicit validation steps. The document structures multi-step processes well (build → test → deploy), includes health checks as verification, and the WRONG/RIGHT pattern makes the correct sequence unambiguous.

3 / 3

Progressive Disclosure

The content is well-organized with clear sections, but it's a monolithic document (~350 lines) that could benefit from splitting detailed examples into separate reference files. The verifier references at the end are good but the main content is dense.

2 / 3

Total

10

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents