CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging-lambda-timeouts

Debugs AWS Lambda function timeout failures by systematically analyzing function configuration, CloudWatch logs and metrics, VPC/networking, cold starts, memory constraints, and downstream dependencies to identify root causes with actionable fixes. Use when a Lambda function is timing out or approaching its timeout limit.

Quality

83%

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

The canonical home for this skill is debugging-lambda-timeouts in aws/agent-toolkit-for-aws

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 well-structured, appropriately delegated skill body: lean overview, one verified one-level-deep reference containing the executable SOP, and condensed troubleshooting with pointers. Main weaknesses are redundant summary text that duplicates the description and itself, plus troubleshooting entries that gesture at checks rather than giving commands.

Suggestions

Collapse the Overview paragraph and the 'The procedure collects...' paragraph into one short section — they restate the frontmatter description and each other (conciseness).

Replace vague troubleshooting directions like 'Check the function's log group configuration and invocation metrics' and 'Verify AWS credentials have permissions' with the concrete AWS CLI commands already present in the reference procedure (actionability).

Surface one or two key validation checkpoints from the procedure inline (e.g., poll aws logs get-query-results until status is 'Complete') so the workflow sequence is visible without opening the reference (workflow_clarity).

DimensionReasoningScore

Conciseness

The Overview paragraph ('Domain expertise for systematically investigating... insufficient timeout settings, external service delays, database connection issues, memory constraints...') and the 'The procedure collects function configuration, CloudWatch metrics and logs, dependency analysis, and cold start patterns' paragraph substantially restate each other and the frontmatter description. Mostly efficient and free of basic-concept padding, but the duplicated summary paragraphs and repeated 'See the full procedure for details' could be tightened — matching anchor 3 rather than 4.

3 / 5

Actionability

Provides one copy-paste command ('aws lambda list-functions --region <region>'), a concrete verified pointer to the executable SOP ('follow the procedure exactly. See [Lambda timeout debugging procedure](references/lambda-timeout-debugging.md)'), and specific troubleshooting directions. Minor gaps: most troubleshooting entries (e.g., 'Check the function's log group configuration and invocation metrics', 'Verify AWS credentials have permissions') lack the concrete commands, so not fully copy-paste ready — anchor 4 rather than 5.

4 / 5

Workflow Clarity

The body gives an unambiguous instruction ('follow the procedure exactly') delegating to a reference containing a 12-step sequenced SOP with explicit validation and error-recovery steps (poll queries until 'Complete', handle MalformedQueryException by adjusting and retrying). The operations are read-only diagnostics so no destructive/batch cap applies; scored 4 rather than 5 because the body itself surfaces no sequence or checkpoints — the sequence lives entirely one file away.

4 / 5

Progressive Disclosure

Verified against the actual bundle: the single referenced path references/lambda-timeout-debugging.md exists, is one level deep, clearly signaled as a markdown link, and carries the full detail (the body's condensed troubleshooting entries point back to it with 'See the full procedure for details'). Clear overview with an appropriately split, well-signaled, easy-to-navigate structure — anchor 5.

5 / 5

Total

16

/

20

Passed

Description

92%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: third-person, concrete, comprehensive about capabilities, with an explicit and natural 'Use when' trigger clause. The only minor gap is that a few common user phrasings (e.g., the 'Task timed out' error text) are not covered among trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'analyzing function configuration, CloudWatch logs and metrics, VPC/networking, cold starts, memory constraints, and downstream dependencies to identify root causes with actionable fixes' — giving comprehensive, specific coverage of the debugging workflow. Anti-drift check: it exceeds 'several specific actions with minor gaps' (4) because every major analysis dimension plus root-cause identification and fixes are explicitly named.

5 / 5

Completeness

Explicitly answers 'what' ('Debugs AWS Lambda function timeout failures by systematically analyzing... to identify root causes with actionable fixes') and 'when' ('Use when a Lambda function is timing out or approaching its timeout limit') with concrete trigger phrases, matching the anchor-5 example structure. Uses third-person voice ('Debugs'), so no voice penalty applies.

5 / 5

Trigger Term Quality

Natural terms users would say are present: 'Lambda function', 'timeout', 'timing out', 'approaching its timeout limit', 'AWS'. Not a 5 because common variations such as the 'Task timed out' error phrase or 'slow/hanging Lambda' phrasings are absent; clearly better than 3 since multiple natural keywords and synonyms appear.

4 / 5

Distinctiveness Conflict Risk

Clear niche (AWS Lambda timeout debugging) with a distinct, specific trigger set; unlikely to fire for unrelated skills. Anti-drift check: it does not merely reduce overlap risk to 'minor' (4) — the domain and triggers are uniquely scoped.

5 / 5

Total

19

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

mreferre/aws-agent-toolkit-skills

Path

.kiro/skills/debugging-lambda-timeouts/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.