CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ecs-deployment

ECS deployment strategies including rolling updates, blue-green with CodeDeploy, canary releases, and GitOps workflows. Covers deployment circuit breakers, rollback strategies, and production deployment patterns. Use when deploying ECS services, implementing blue-green deployments, setting up CI/CD pipelines, or managing production releases.

Quality

79%

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/ecs-deployment/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 delivers concrete, largely executable guidance across all four deployment strategies with real validation machinery (circuit breaker, deployment monitoring, auto-rollback), but token efficiency and progressive disclosure are undermined by substantial duplication with the reference file, a repeated circuit-breaker block, and two of three referenced files missing from the bundle. Fixing the dangling references and moving the duplicated deep-dive content out of SKILL.md would lift the two weakest dimensions.

Suggestions

Create the missing references/cicd-pipelines.md and references/deployment-monitoring.md (or remove them from 'Detailed References'), since two of the three cited follow-up files do not exist in the bundle.

Remove the duplicated ~140-line CodeDeploy Terraform configuration and the ASCII architecture diagram from SKILL.md, keeping only a concise summary and a pointer to references/blue-green-setup.md, which already contains both.

Delete the verbatim repeat of the deployment_circuit_breaker HCL in the 'Deployment Circuit Breaker' section (it already appears fully in 'Rolling Updates'), and fix shift_traffic() so rule_arn, stable_tg_arn, and canary_tg_arn are passed as parameters instead of referenced as undefined globals.

DimensionReasoningScore

Conciseness

The body is mostly dense, useful configuration and code rather than padded prose, but it carries clear duplication that should be tightened: the full ~140-line CodeDeploy Terraform block in 'Terraform with CodeDeploy' largely repeats what is already in references/blue-green-setup.md, the deployment_circuit_breaker HCL appears verbatim in both the 'Rolling Updates' and 'Deployment Circuit Breaker' sections, the ASCII architecture diagram is duplicated in the reference file, and the ~50-line GitHub Actions workflow duplicates content attributed to references/cicd-pipelines.md. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than anchor 4, whose minor trimmings do not approach this volume of redundant tokens.

3 / 5

Actionability

The guidance is mostly executable and copy-paste ready: complete Terraform resources, a boto3 rolling-update function with a realistic usage call, a deployment monitor that checks rolloutState, a CodeDeploy create_deployment trigger, and a manual rollback function. It falls short of 5 on minor gaps: shift_traffic() references undefined variables (rule_arn, stable_tg_arn, canary_tg_arn are never passed as parameters or defined), wait_for_deployment depends on the module-level ecs client from a previous snippet, and rollback_to_previous naively assumes revision-1 is the previous good version. These are gaps, not pseudocode, so it is clearly above anchor 3.

4 / 5

Workflow Clarity

Sequences are clearly laid out (the 5-step rolling-update behavior, the 4-step circuit-breaker operation) and validation checkpoints exist for the risky deployment operations: wait_for_deployment detects FAILED rolloutState and reports rolloutsStateReason, circuit breaker rollback and CodeDeploy auto_rollback_configuration provide automatic failure recovery. The gap keeping it at 4 rather than 5 is the canary workflow, where '# Monitor metrics...' is a placeholder with no concrete guidance on which metrics to check or how to abort a bad canary; the destructive-operation cap at 3 does not apply because validation and auto-rollback are explicitly present, not missing.

4 / 5

Progressive Disclosure

Section structure itself is good (Quick Reference table, per-strategy sections, a dedicated 'Progressive Disclosure' section), but scored against the actual bundle: of the three files referenced in 'Detailed References', only references/blue-green-setup.md exists — references/cicd-pipelines.md and references/deployment-monitoring.md are dangling. Meanwhile the content that belongs in those files (the full GitHub Actions workflow, the duplicated CodeDeploy Terraform) is inlined in SKILL.md, matching anchor 3's 'content that should be separate is inline'. It does not reach anchor 4 because broken navigation to two of three references is more than a 'minor organization gap'.

3 / 5

Total

14

/

20

Passed

Description

88%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 that follows the what-plus-when pattern with concrete, third-person capability statements and an explicit 'Use when...' trigger clause covering four realistic scenarios. Keyword coverage is good though it omits a few common synonyms (AWS ECS, Fargate, ECR), and there is minor overlap risk with adjacent infrastructure-as-code and CI/CD skills.

DimensionReasoningScore

Specificity

Lists multiple concrete, specific actions with comprehensive coverage: "rolling updates, blue-green with CodeDeploy, canary releases, and GitOps workflows" plus "deployment circuit breakers, rollback strategies, and production deployment patterns". It clearly matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' rather than the anchor 4 example, which presumes minor gaps in coverage; every major ECS deployment strategy is named. Third person voice is used consistently ('Covers deployment circuit breakers'), so no voice penalty applies.

5 / 5

Completeness

Explicitly answers both what ("ECS deployment strategies including rolling updates, blue-green with CodeDeploy, canary releases, and GitOps workflows") and when ("Use when deploying ECS services, implementing blue-green deployments, setting up CI/CD pipelines, or managing production releases") with concrete trigger phrases — a direct match for the anchor 5 example pattern. It is not a 4, since the 'when' clause is not merely present but enumerates four specific triggering scenarios.

5 / 5

Trigger Term Quality

Good keyword coverage of natural phrases users would say: "ECS deployment", "rolling updates", "blue-green deployments", "canary releases", "CI/CD pipelines", "production releases". Not a 5 because common variations and synonyms are missing (e.g., 'AWS ECS', 'Fargate', 'task definition', 'ECR'), whereas the 5 anchor expects comprehensive coverage including synonyms and extensions; it is well above the 3 anchor ('some relevant keywords but missing common variations') because most natural deployment phrasings are present.

4 / 5

Distinctiveness Conflict Risk

A clear niche (ECS deployments) with distinct trigger terms like CodeDeploy, canary releases, and circuit breakers. Minor overlap risk remains with closely related skills the body itself names ('boto3-ecs', 'terraform-ecs'), whose scope could collide on ECS configuration tasks; it does not reach the 5 anchor's 'minimal conflict risk' because terms like 'CI/CD pipelines' could also plausibly route to a generic CI/CD skill.

4 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (564 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 2 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/ecs-deployment/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.