CtrlK
BlogDocsLog inGet started
Tessl Logo

deployment-patterns

Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications. Use when setting up deployment infrastructure or planning releases.

61

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./.kiro/skills/deployment-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 reference skill whose Dockerfiles, CI pipeline, and rollback commands are executable and concrete. Its weaknesses are redundancy (duplicated activation sections, teaching standard deployment strategies Claude already knows) and the complete absence of progressive disclosure — everything is inlined in one large file rather than split into referenced bundle files.

Suggestions

Split the three language-specific Dockerfiles (Node.js, Go, Python/Django) and the GitHub Actions pipeline into files under references/ (e.g., references/dockerfiles.md, references/ci-pipeline.md), keeping one canonical example inline and linking the rest to reduce SKILL.md to a navigable overview.

Remove the duplicated 'When to Use This Skill' section (it repeats 'When to Activate' verbatim) and condense the rolling/blue-green/canary ASCII walkthroughs into a short decision table — Claude already knows these strategies; keep only the 'Use when' guidance.

Cut the Twelve-Factor env-var primer to just the zod validation pattern (the actionable part) and drop the generic intro line, or fold environment configuration into a single section to tighten token efficiency.

DimensionReasoningScore

Conciseness

The bulk is efficient, executable reference material, but it includes unnecessary explanation of concepts Claude already knows: ASCII play-by-play diagrams with pros/cons for the standard rolling/blue-green/canary strategies, a Twelve-Factor environment-variable primer, and a 'When to Use This Skill' section that exactly duplicates 'When to Activate'. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Nearly everything is copy-paste ready: three complete multi-stage Dockerfiles, a full GitHub Actions pipeline, a zod startup-validation schema, concrete rollback commands per platform, and Kubernetes probe YAML. The deploy job's placeholder is explicitly justified ('Platform-specific deployment command' with Railway/Vercel/kubectl alternatives listed), and the only trivial gap (undefined checkRedis/checkExternalApi helpers) does not prevent execution of the common cases — matching the 'fully executable, copy-paste ready' anchor.

5 / 5

Workflow Clarity

The 'Pipeline Stages' section gives a clear sequenced flow ('lint → typecheck → unit tests → … → smoke tests → deploy production') and the rollback and production-readiness checklists provide substantial validation checkpoints. It stays at 4 rather than 5 because there is no single end-to-end deployment workflow with an explicit validate → fix → retry loop, and the content is organized by topic rather than as one guided process.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so the entire ~440-line body — including three language-specific Dockerfiles and a full pipeline YAML that clearly belong in separate reference files — is inlined in SKILL.md. Section headers are well organized, matching 'some structure but content that should be separate is inline'; the under-50-lines exception does not apply, and it is not 2 because structure and navigation are genuinely good.

3 / 5

Total

15

/

20

Passed

Description

75%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 solid description that names the domain comprehensively and includes an explicit 'Use when' clause with good natural trigger coverage. Its main weaknesses are the absence of concrete trigger phrases in the when-clause and a few missing common synonyms (Kubernetes, deploy as a verb), which keep every dimension at 4 rather than 5.

DimensionReasoningScore

Specificity

The description lists six concrete capability areas — 'Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists' — with only minor gaps (e.g., environment configuration and Kubernetes probes from the body are unmentioned). It stays at 4 rather than 5 because these are domain topics phrased as noun phrases, not the multiple concrete actions (e.g., 'Extract text… fill forms') of the top anchor.

4 / 5

Completeness

It answers both questions explicitly: the first sentence gives the 'what' and 'Use when setting up deployment infrastructure or planning releases' gives the 'when', matching the anchor where 'when' could be more explicit or specific. It is not 3 (the when-clause is present and explicit, not weakly implied) nor 5 (the when-clause lacks concrete trigger phrases like 'when the user mentions Docker or CI/CD').

4 / 5

Trigger Term Quality

It includes most natural trigger terms a user would say — 'CI/CD', 'Docker', 'deployment', 'health checks', 'rollback', 'releases', 'pipeline' — matching the 'good keyword coverage, a few natural terms missing' anchor. It falls short of 5 because common synonyms/extensions like Kubernetes/k8s, staging, or the plain verb 'deploy' are absent.

4 / 5

Distinctiveness Conflict Risk

The deployment/CI-CD/rollback niche is clearly distinguishable from adjacent skills and uses consistent third-person phrasing, carrying only minor overlap risk with a generic devops or containerization skill — matching the 'mostly distinct' anchor rather than the 'clear niche with distinct triggers' of 5.

4 / 5

Total

16

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
affaan-m/ECC
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.