CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

boto3-ecs

AWS Boto3 SDK patterns for Amazon ECS cluster management, task definitions, services, and Fargate deployments. Use when working with ECS clusters, managing task definitions, deploying services, running one-off tasks, monitoring deployments, or integrating ECS with Python applications.

Quality

82%

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

The canonical home for this skill is boto3-ecs in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

68%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 well-structured, highly actionable reference whose code is nearly all copy-paste executable and whose bundle references are real, clearly signaled, and one level deep. Weaknesses are concentrated in workflow safety (no verification around destructive operations) and one unreliable error-handling snippet.

Suggestions

Add verification around destructive operations: before delete_service, wait for running tasks to drain (describe_services desiredCount==0 / tasks_stable waiter) and confirm; after stop_task, poll describe_tasks until lastStatus is STOPPED.

Replace the ecs.exceptions.ClusterNotFoundException / ServiceNotFoundException catches with a single ClientError handler keyed off e.response['Error']['Code'] (botocore does not model ECS service exception classes), so the snippet is executable as written.

Trim duplication and bulk: remove or shorten 'When to Use This Skill' (duplicates the frontmatter description), and move the full register_task_definition and monitor_deployment examples into the corresponding references/ files to keep SKILL.md a lean overview.

DimensionReasoningScore

Conciseness

The body is dominated by dense, executable code with almost no explanation of concepts Claude already knows, matching 'efficient; minor instances of over-explanation that could be trimmed'. Trim candidates: the 'When to Use This Skill' section repeats the frontmatter description nearly verbatim, and the 'Quick Start (This File)' bullet list plus 'Related Skills' are navigational padding. Not a 5 because of that duplication; not a 3 since there is no conceptual padding.

4 / 5

Actionability

Nearly all sections are copy-paste-ready executable code covering common cases (client init, cluster CRUD, task definition registration, service CRUD, run_task with overrides, waiters, a monitoring loop), which approaches the 5 anchor. The gap is the error-handling snippet's `except ecs.exceptions.ClusterNotFoundException` / `ServiceNotFoundException` — botocore does not model per-service error classes for ECS (these would raise AttributeError; the reliable pattern is catching ClientError and inspecting e.response['Error']['Code']), so that snippet is not safely executable as written.

4 / 5

Workflow Clarity

The sections imply a sensible order (cluster → task definition → service → tasks → error handling → waiters → monitoring) and deployments do have checkpoint patterns (services_stable/tasks_running waiters, rolloutState monitoring, circuit breaker settings). However, destructive operations lack any verification: delete_service scales to 0 and deletes immediately without waiting for tasks to stop, and stop_task has no confirmation — per the rubric, missing validation on destructive/batch operations caps workflow clarity at 3.

3 / 5

Progressive Disclosure

A dedicated 'Progressive Disclosure' section clearly signals one-level-deep references (cluster-operations.md, task-definitions.md, service-management.md — all verified to exist with substantial matching content), which is close to the 5 anchor. Held at 4 because the ~390-line body inlines substantial detail that could live in the references (full register_task_definition with secrets, capacity provider strategy, the complete monitor_deployment function) rather than being a lean overview.

4 / 5

Total

15

/

20

Passed

Description

87%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 states concrete capabilities in third person and includes an explicit, detailed 'Use when...' clause covering the full ECS workflow surface. The only refinement available is converting the noun-based 'what' clause into action-led language and adding a few container-oriented synonyms.

DimensionReasoningScore

Specificity

The 'when' clause lists several concrete verb-led actions ("managing task definitions, deploying services, running one-off tasks, monitoring deployments, or integrating ECS with Python applications"), which approaches comprehensive coverage. It sits just below the 5 anchor because the 'what' clause is noun-based ("AWS Boto3 SDK patterns for Amazon ECS cluster management, task definitions, services, and Fargate deployments") — naming capability areas rather than concrete actions — and clearly exceeds the 3 anchor ('1-2 concrete actions').

4 / 5

Completeness

Clearly and explicitly answers both 'what' ("AWS Boto3 SDK patterns for Amazon ECS cluster management, task definitions, services, and Fargate deployments") and 'when' ("Use when working with ECS clusters, managing task definitions, deploying services, running one-off tasks, monitoring deployments, or integrating ECS with Python applications") with concrete trigger phrases — a direct match for the 5 anchor, not the 4 anchor where 'when' could be more explicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "ECS clusters", "task definitions", "deploying services", "running one-off tasks", "monitoring deployments", "Fargate", "Python applications" — phrases users would plausibly say. Missing a few natural synonyms/variations (e.g., "containers", "Docker", "containerized workloads"), so it falls between the 4 ('good coverage, a few natural terms missing') and 5 anchors, closer to 4.

4 / 5

Distinctiveness Conflict Risk

The boto3/Python + ECS combination carves a clear niche distinct from adjacent skills (e.g., Terraform-based or CLI-based ECS management), and the triggers are ECS-specific, so it is unlikely to fire for the wrong skill. Matches the 5 anchor ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

18

/

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

fernandezbaptiste/Skrillz

Path

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