CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

troubleshooting-application-failures

Troubleshoots failing applications by discovering and analyzing CloudWatch log groups to identify error patterns, root causes, and actionable solutions. Use when an application is experiencing failures and log-based diagnosis is needed.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 skill body that keeps SKILL.md as a lean overview and correctly delegates the detailed procedure to a single, clearly signaled reference file. The guidance is concrete (named permissions, log group patterns, specific timeout configurations) with strong error-recovery coverage; the only notable improvement is trimming the Overview paragraph that duplicates the frontmatter description.

DimensionReasoningScore

Conciseness

The 35-line body is lean with no explanations of concepts Claude already knows, and the "Logs are where the investigation starts, not its boundary" paragraph is genuine domain guidance. It falls just short of anchor 5 because the first Overview paragraph ("Discovers relevant log groups, searches for error patterns and stack traces, performs root cause analysis, and generates prioritized remediation recommendations") largely restates the frontmatter description and could be trimmed.

4 / 5

Actionability

Concrete, specific guidance is present: the exact IAM permissions ("logs:DescribeLogGroups, logs:DescribeLogStreams, logs:StartQuery, logs:GetQueryResults"), common log group naming patterns ("/aws/lambda/function-name", "/aws/apigateway/api-name"), and named configuration sources ("API Gateway integration timeout, the queue's visibility timeout, or the function timeout and event source mapping"). It is not anchor 5 because the executable procedure itself is delegated to the reference file rather than being copy-paste ready in the body, and query examples are absent from the body.

4 / 5

Workflow Clarity

The body directs "follow the procedure exactly" to a clearly signaled 9-step reference procedure that includes explicit validation steps ("Verify Dependencies", "Validate Log Groups and Check Availability", "Wait for Log Query Results"), and the body's Troubleshooting section adds error-recovery loops for three failure modes (no log groups, access denied, query timeouts). This matches the anchor for a clear sequence with explicit validation and feedback loops for error recovery; this is a read-only diagnostic skill, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The body is a concise overview with one clearly signaled, one-level-deep reference — [Application failure troubleshooting procedure](references/application-failure-troubleshooting.md) — which exists in the bundle, contains the detailed procedure, and itself references no further files (no nested references). This matches the anchor for a clear overview with well-signaled one-level-deep references and appropriately split content.

5 / 5

Total

18

/

20

Passed

Description

83%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 clearly states what the skill does and when to use it, with concrete domain-specific actions around CloudWatch log analysis. The main improvement opportunities are adding common trigger synonyms (errors, debugging) and narrowing the 'when' clause to further reduce overlap with non-log-based troubleshooting skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "discovering and analyzing CloudWatch log groups", "identify error patterns, root causes, and actionable solutions" — closely matching the anchor for several specific actions with minor gaps in coverage (e.g., report generation and specific AWS service context beyond CloudWatch are not named). It does not reach the comprehensive-coverage anchor 5 because the actions describe a single diagnostic pipeline rather than a fully broad capability set.

4 / 5

Completeness

Both parts are explicit: what — "Troubleshoots failing applications by discovering and analyzing CloudWatch log groups to identify error patterns, root causes, and actionable solutions"; when — "Use when an application is experiencing failures and log-based diagnosis is needed". The 'when' clause contains concrete trigger phrases, matching the anchor that clearly and explicitly answers both what and when; it exceeds anchor 4, where the 'when' is present but less explicit.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "failing applications", "experiencing failures", "log-based diagnosis", "CloudWatch log groups". A few common natural terms are missing ("errors", "debugging", "crashes", "production issues"), which matches the good-but-not-comprehensive keyword coverage anchor rather than anchor 5's synonym-complete coverage.

4 / 5

Distinctiveness Conflict Risk

CloudWatch log-based failure diagnosis is a distinct niche with specific triggers, but the broad trigger "an application is experiencing failures" could also match metrics-based or general AWS troubleshooting skills, leaving minor overlap risk with closely related skills. This sits between anchor 4 and anchor 5, fitting anchor 4 better because the trigger is not as narrowly qualified as a minimal-conflict niche would require.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

aws/agent-toolkit-for-aws

Path

skills/specialized-skills/operations-skills/troubleshooting-application-failures/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.