CtrlK
BlogDocsLog inGet started
Tessl Logo

devops-infrastructure

Guides Docker, CI/CD pipelines, deployment strategies, infrastructure as code, and observability setup. Use when writing Dockerfiles, configuring GitHub Actions, planning deployments, setting up monitoring, or when asked about containers, pipelines, Terraform, or production infrastructure.

61

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/devops-infrastructure/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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.

The body excels at actionability — complete, executable code examples for Docker, CI/CD, Terraform, and monitoring — and is organized into clear sections. It loses points for breadth-as-a-monolith: no progressive disclosure (everything inline, no references/), textbook concept sections that restate what Claude already knows, and a setup checklist that defers all validation to a final step instead of per-step checkpoints.

Suggestions

Add per-step validation checkpoints to the setup checklist (e.g., 'verify the image builds, is non-root, and is reasonably sized before starting Step 2'; 'confirm the pipeline passes on a branch before enabling deploy') instead of validating only at Step 7.

Split topic-specific deep material (full CI/CD workflow YAML, Dockerfile templates, Terraform files) into references/ files (e.g., references/ci-cd.md, references/docker.md, references/terraform.md) and keep SKILL.md as a lean overview with one-level-deep pointers.

Trim sections that restate textbook knowledge — the blue-green/canary/rolling definitions, the 'Three Pillars' overview, and the generic Express health-check and feature-flag code — down to only the house-specific preferences (chosen thresholds, alerting rules, pinned versions).

DimensionReasoningScore

Conciseness

The body is terse and reference-style (WRONG/CORRECT code contrasts, no padded prose), but several sections restate textbook concepts Claude already knows: blue-green/canary/rolling deployment definitions with pros/cons, the 'Three Pillars' metrics/logs/traces overview, a basic Express health-check endpoint, and a trivial env-var feature-flag implementation. That puts it above score 2 (which features prose padding) but below score 4, since these ~100+ lines of well-known material could be trimmed to house-specific preferences only.

3 / 5

Actionability

Nearly all guidance is complete, executable, copy-paste-ready code: full multi-stage Dockerfiles for Node and Python, a complete GitHub Actions workflow with services and caching, Terraform files with backend/variables, a docker-compose dev stack, and concrete alert thresholds ('Error rate > 1% for 5 minutes'). This matches the score-5 anchor; the one stub ('echo "Deploy to production"') is an illustrative placeholder in an otherwise fully concrete workflow, so score 4's 'minor gaps' anchor is a worse fit.

5 / 5

Workflow Clarity

The 7-step 'DevOps Setup Progress' checklist gives a clear sequence, but validation checkpoints are missing or implicit between steps — the only checkpoint is 'Step 7: Validate against anti-patterns checklist' at the very end, with no per-step verification (e.g., confirm the image builds and is non-root before moving to CI/CD). Validation appears only scattered inside sections (terraform plan, blue-green smoke tests), matching the score-3 anchor 'steps listed but checkpoints missing or implicit'; the checklist alone does not reach score 4's 'most checkpoints present', especially for deployment work where missed verification is costly.

3 / 5

Progressive Disclosure

No bundle files exist and all ~480 lines live inline in SKILL.md, organized under clear section headers. This fits the score-3 anchor 'content that should be separate is inline': the full GitHub Actions workflow, complete Dockerfiles, and Terraform files would serve better as references/ files with SKILL.md as an overview. It is above score 2 (whose example is a header-less monolith — here sectioning is good) but below score 4, which expects most content appropriately split across files.

3 / 5

Total

14

/

20

Passed

Description

78%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 clearly states what the skill covers and gives an explicit, multi-trigger 'Use when' clause in third person with natural terminology. Its main weakness is that the capability statement relies on one generic verb ('Guides') applied to a domain list rather than enumerating concrete actions, and a few common trigger synonyms (Kubernetes/k8s) are absent.

DimensionReasoningScore

Specificity

The 'what' is 'Guides Docker, CI/CD pipelines, deployment strategies, infrastructure as code, and observability setup' — five well-named domains, but the only action verbs are the generic 'Guides' and 'setup', with no concrete operations like 'writes Dockerfiles' or 'configures pipelines'. This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' more than score 4, which requires several distinct specific actions; it is above score 2 because the domains themselves are concretely enumerated rather than generic.

3 / 5

Completeness

It explicitly answers both questions: a clear 'what' ('Guides Docker, CI/CD pipelines, deployment strategies, infrastructure as code, and observability setup') and an explicit 'when' with multiple concrete trigger phrases ('Use when writing Dockerfiles, configuring GitHub Actions, ... or when asked about containers, pipelines, Terraform, or production infrastructure'). This directly matches the score-5 anchor; the 'when' clause is explicit and specific, so score 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

The trigger clause surfaces natural terms users would say: 'writing Dockerfiles, configuring GitHub Actions, planning deployments, setting up monitoring, or when asked about containers, pipelines, Terraform, or production infrastructure'. Good keyword coverage, but a few common natural terms are missing (Kubernetes/k8s, Helm, CI, .github/workflows), so it falls short of the score-5 'comprehensive coverage including synonyms and file extensions' anchor.

4 / 5

Distinctiveness Conflict Risk

The DevOps/infrastructure niche is clearly defined with distinct triggers (Dockerfiles, GitHub Actions, Terraform, production infrastructure), making it mostly distinct with only minor overlap risk against closely related skills (e.g., a hypothetical cloud- or Kubernetes-specific skill). It is not score 5 because the domain is broad enough that narrowly scoped infrastructure skills would partially collide, and not score 3 because the named technologies anchor it to a specific niche rather than a generic category.

4 / 5

Total

16

/

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
CloudAI-X/claude-workflow-v2
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.