CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ecs-troubleshooting

ECS troubleshooting and debugging guide covering task failures, service issues, networking problems, and performance diagnostics. Use when diagnosing ECS issues, debugging task failures (STOPPED, PENDING), resolving networking problems, investigating IAM/permissions errors, troubleshooting container health checks, or analyzing ECS service health.

Quality

80%

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 ./.claude/skills/ecs-troubleshooting/SKILL.md

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

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.

A genuinely useful, highly actionable diagnostic reference with concrete commands and symptom-to-fix mapping, but it functions as a monolithic reference document rather than a progressive-disclosure skill. The workflow lacks verification loops, and substantial reference material (IAM/Terraform snippets, scripts) belongs in bundle files.

Suggestions

Split reference material into bundle files (e.g., references/iam-policies.md, references/networking-terraform.md, scripts/diagnose_task.py) and keep SKILL.md as a triage overview with one-level-deep, clearly signaled pointers.

Add a verification step after each solution (e.g., re-run 'aws ecs describe-services' to confirm runningCount reaches desiredCount) to close the feedback loop.

Deduplicate content — CannotPullContainerError and image-pull troubleshooting appear in both the Task Failures and IAM & Permissions sections; consolidate them under a single cross-referenced entry.

DimensionReasoningScore

Conciseness

The body is dense with commands, symptoms, and fixes rather than explanations of concepts Claude already knows, so most tokens earn their place. It is not a 5 because of duplication that could be tightened: CannotPullContainerError and image-pull causes appear in both the Task Failures and IAM sections, and the same log-tail command is repeated.

4 / 5

Actionability

Highly actionable throughout — copy-paste AWS CLI commands with --query projections, runnable boto3 diagnostic functions, Terraform fixes, and CloudWatch Insights queries mapped to specific error strings. Not a 5 because of minor gaps: the metrics function omits the datetime/timedelta import, Terraform snippets reference undefined resources (aws_eip.nat, aws_subnet.public), and some snippets are fragments.

4 / 5

Workflow Clarity

A triage flow exists — 'Quick Diagnostic Commands' up front and a symptom → first check → common cause table at the end, with per-symptom Diagnostic Steps sections — but checkpoints are implicit. No step verifies a fix worked (e.g., re-run describe-services after applying a solution), so it matches the anchor of steps listed with validation gaps.

3 / 5

Progressive Disclosure

Sections are well organized with clear headers, but ~590 lines of detailed material (IAM policy JSON, Terraform networking configs, full diagnostic scripts, log-query reference) are inlined in SKILL.md with no bundle files, where the rubric expects an overview pointing to one-level-deep references. This matches 'some structure... content that should be separate is inline' rather than the minimal-structure anchor below it.

3 / 5

Total

14

/

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: it clearly states what the skill covers, uses third person, and includes an explicit 'Use when...' clause with concrete, natural trigger phrases. Minor room to improve by adding commonly-said synonyms (Fargate, deployment, cannot pull image) and framing the 'what' as concrete actions rather than coverage categories.

DimensionReasoningScore

Specificity

The description lists several specific coverage areas ("task failures, service issues, networking problems, and performance diagnostics") plus concrete trigger activities like "debugging task failures (STOPPED, PENDING)" and "investigating IAM/permissions errors". It falls short of a 5 because the 'what' is phrased as coverage categories of a guide rather than multiple discrete concrete actions, leaving minor gaps.

4 / 5

Completeness

Both parts are explicit: 'what' is "ECS troubleshooting and debugging guide covering task failures, service issues, networking problems, and performance diagnostics", and 'when' is a concrete "Use when..." clause enumerating six trigger scenarios. This matches the anchor for clearly and explicitly answering both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural user phrasing is well covered: "diagnosing ECS issues", "debugging task failures (STOPPED, PENDING)", "resolving networking problems", "troubleshooting container health checks". Not a 5 because common variations a user would actually say are missing — e.g., Fargate, deployment stuck, cannot pull image, ECR, container exits/crashes.

4 / 5

Distinctiveness Conflict Risk

"ECS" scopes the skill to a clear niche with distinct triggers (task STOPPED/PENDING, container health checks, ECS service health), so it is unlikely to fire for unrelated skills. Unlike neighboring anchors that describe generic domains, the ECS qualifier plus specific status keywords gives minimal conflict risk.

5 / 5

Total

18

/

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

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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