Official agent skill

Debugging Lambda Timeouts

by aws in aws/agent-toolkit-for-aws

Debugs AWS Lambda function timeout failures by systematically analyzing function configuration, CloudWatch logs and metrics, VPC/networking, cold starts, memory constraints, and downstream…

OfficialApache-2.0Auto-check passedDevelopment

Install Debugging Lambda Timeouts

skills CLI
$ npx skills add aws/agent-toolkit-for-aws --skill debugging-lambda-timeouts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aws/agent-toolkit-for-aws debugging-lambda-timeouts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aws/agent-toolkit-for-aws.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/specialized-skills/serverless-skills/debugging-lambda-timeouts .claude/skills/debugging-lambda-timeouts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debugging-lambda-timeouts
GitHub stars
2.8k
Token cost
~502 tokens
SKILL.md length
207 words
Files
2 (incl. references)
Skills in repo
138
Repo updated
First seen
Licence
Apache-2.0

At a glance

Debugs AWS Lambda function timeout failures by systematically analyzing function configuration, CloudWatch logs and metrics, VPC/networking, cold starts, memory constraints, and downstream…

  • A Lambda function is timing out
  • SKILL.md covers Overview, Debug a Lambda timeout and Troubleshooting
  • Calls aws
  • Approaching its timeout limit

What it does

Debugging Lambda Timeouts is an agent skill from aws/agent-toolkit-for-aws, published by the product's own GitHub organization. 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.

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/lambda-timeout-debugging.md`).

It sits in Development, covering Serverless, Debugging and Root cause analysis. It works with AWS Lambda and Amazon Web Services. The repository describes itself as: Official, AWS-supported MCP servers, skills, and plugins to help AI agents build on AWS. The licence is Apache-2.0.

When your agent uses it

  • A Lambda function is timing out
  • Approaching its timeout limit

Example prompts

  • “Use the debugging-lambda-timeouts skill to debug AWS Lambda function timeout failures by systematically analyzing function configuration, CloudWatch…”
  • “/debugging-lambda-timeouts”

What it can do on your machine

Read from SKILL.md and the folder at commit 188af2f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • aws

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use aws, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debugging Lambda Timeouts loads about 502 tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 87 tokens; SKILL.md has 207 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~502
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aws/agent-toolkit-for-aws at commit 188af2f, republished under its Apache-2.0 licence (© aws). 207 words, ~502 tokens.

Download SKILL.mdSave it as .claude/skills/debugging-lambda-timeouts/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
debugging-lambda-timeouts
description
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.
version
1

Debugging Lambda Timeouts

Overview

Domain expertise for systematically investigating AWS Lambda function timeout failures by analyzing function configuration, CloudWatch logs, metrics, dependencies, cold start patterns, and code. Identifies common causes such as insufficient timeout settings, external service delays, database connection issues, memory constraints, and inefficient code patterns, then provides prioritized recommendations.

Debug a Lambda timeout

To investigate and resolve Lambda timeout issues, follow the procedure exactly. See Lambda timeout debugging procedure.

The procedure collects function configuration, CloudWatch metrics and logs, dependency analysis, and cold start patterns. If Lambda code is provided, it also reviews the code for timeout-prone patterns. Results are compiled into a structured debugging report with prioritized recommendations.

Troubleshooting

Function not found

Verify the function name and region. Use aws lambda list-functions --region <region> to list available functions.

No logs available

The function may not have been invoked recently or logging may be disabled. Check the function's log group configuration and invocation metrics.

Access denied errors

Verify AWS credentials have permissions for Lambda, CloudWatch Logs, and CloudWatch Metrics. See the full procedure for details.

Log query time range issues

If CloudWatch Logs Insights queries fail with time range errors, reduce the analysis window or check log group retention settings. See the full procedure for details.

© aws, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/specialized-skills/serverless-skills/debugging-lambda-timeouts of aws/agent-toolkit-for-aws.

  • SKILL.md
  • references/lambda-timeout-debugging.md

Open the folder on GitHubat commit 188af2f

Compare with similar skills

Debugging Lambda Timeouts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debugging Lambda Timeouts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debugging Lambda Timeouts this skillaws/agent-toolkit-for-aws2.8k—~502Automated safety check: PassApache-2.0
CRM Production Investigation Guidelinesaws/tools-for-devops-agent100—~983Automated safety check: PassApache-2.0
AWS Sam Bootstrapgiuseppe-trisciuoglio/developer-kit355—~954Automated safety check: NotesMIT
AWS Serverless Edazxkane/aws-skills3674 repos~3.2kAutomated safety check: PassMIT
AWS Serverlessdavila7/claude-code-templates32k8 repos~2kAutomated safety check: PassMIT
AWS Lambda Microvmsawslabs/agent-plugins9151 repos~4.1kAutomated safety check: PassApache-2.0

Similar skills

  • CRM Production Investigation Guidelines

    aws/tools-for-devops-agent

    Official

    Guidelines for investigating production incidents in the CRM application.

    100 GitHub stars~983 tokensUpdated today
    Sales & SupportAuto-check passed
  • AWS Sam Bootstrap

    giuseppe-trisciuoglio/developer-kit

    Provides AWS SAM bootstrap patterns: generates template.yaml and samconfig.toml for new projects via sam init, creates SAM templates for existing Lambda/CloudFormation code migration, validates…

    355 GitHub stars~954 tokensUpdated 27 days ago
    Backend & APIsAuto-check: notes
  • AWS Serverless Eda

    zxkane/aws-skills

    AWS serverless and event-driven architecture expert based on Well-Architected Framework.

    367 GitHub starsUsed in 4 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • AWS Serverless

    davila7/claude-code-templates

    Specialized skill for building production-ready serverless applications on AWS.

    32k GitHub starsUsed in 8 repos~2k tokens
    Backend & APIsAuto-check passed
  • AWS Lambda Microvms

    awslabs/agent-plugins

    Official

    Build, run, debug, and operate applications on AWS Lambda MicroVMs — Firecracker-isolated, snapshot-resumable serverless compute environments that run inside a container with up to 8-hour lifetimes.

    915 GitHub starsUsed in 1 repo~4.1k tokens
    Backend & APIsAuto-check passed
  • AWS Lambda Durable Functions

    awslabs/agent-plugins

    Official

    Build resilient, long-running, multi-step applications with AWS Lambda durable functions with automatic state persistence, retry logic, and orchestration for long-running executions.

    915 GitHub stars~2.3k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from aws/agent-toolkit-for-aws

All 138 skills in this repo
  • Agent Advisor

    aws/agent-toolkit-for-aws

    Official

    Entry point for AI-agent work on AWS: pick a runtime, plan a migration for existing workloads, and build an executable POC — one phased flow.

    2.8k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Agents Build

    aws/agent-toolkit-for-aws

    Official

    A skill your agent uses to extend an existing agent project with memory, app integration, VPC, multi-agent, migration, model, browser, code interpreter, payments, or resource removal.

    2.8k GitHub stars~2.3k tokensUpdated today
    Auto-check: notes
  • Launch With AWS

    aws/agent-toolkit-for-aws

    Official

    Migrates vibe-coded web applications to AWS. An agent skill from aws/agent-toolkit-for-aws.

    2.8k GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Official

    Deploy an event-driven workflow that routes S3 uploads to either Lambda or Fargate via Step Functions based on file size.

    2.8k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • AWS Marketplace Metering

    aws/agent-toolkit-for-aws

    Official

    Deploys, queries, and debugs AWS Marketplace usage-based (PAYG) metering — the pipeline (ResolveCustomer, BatchMeterUsage, EventBridge via SAM) and querying/debugging metering records, statuses…

    2.8k GitHub stars~18k tokensUpdated today
    Auto-check passed
  • Agents Pay

    aws/agent-toolkit-for-aws

    Official

    A skill your agent uses when THIS agent needs to pay for x402-protected content at runtime: hitting a paywall mid-task, settling it via AgentCore Payments, and applying operator-defined spend limits.

    2.8k GitHub stars~6.5k tokensUpdated today
    Auto-check: notes

Questions about Debugging Lambda Timeouts

What does Debugging Lambda Timeouts do?

Debugs AWS Lambda function timeout failures by systematically analyzing function configuration, CloudWatch logs and metrics, VPC/networking, cold starts, memory constraints, and downstream…. Debugging Lambda Timeouts is an agent skill from aws/agent-toolkit-for-aws, published by the product's own GitHub organization. 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.

When should I use Debugging Lambda Timeouts?

Debugging Lambda Timeouts fits situations like: A Lambda function is timing out; approaching its timeout limit.

How do I install Debugging Lambda Timeouts in Claude Code?

Run `npx skills add aws/agent-toolkit-for-aws --skill debugging-lambda-timeouts -a claude-code`. Or copy the skill folder (skills/specialized-skills/serverless-skills/debugging-lambda-timeouts in aws/agent-toolkit-for-aws) into .claude/skills/debugging-lambda-timeouts in your project. Claude Code loads it when a task matches its description.

How do I install Debugging Lambda Timeouts in Codex?

Run `npx skills add aws/agent-toolkit-for-aws --skill debugging-lambda-timeouts -a codex`. Or copy the skill folder (skills/specialized-skills/serverless-skills/debugging-lambda-timeouts in aws/agent-toolkit-for-aws) into .agents/skills/debugging-lambda-timeouts in your project. Codex loads it when a task matches its description.

Can I use Debugging Lambda Timeouts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aws/agent-toolkit-for-aws --skill debugging-lambda-timeouts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debugging-lambda-timeouts, .gemini/skills/debugging-lambda-timeouts, .github/skills/debugging-lambda-timeouts and .opencode/skills/debugging-lambda-timeouts in your project.

What does Debugging Lambda Timeouts need to run?

Going by SKILL.md and its folder, Debugging Lambda Timeouts needs the command-line tools its instructions call (aws).

Does Debugging Lambda Timeouts access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Debugging Lambda Timeouts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Debugging Lambda Timeouts use?

Debugging Lambda Timeouts is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Debugging Lambda Timeouts use?

About 502 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.2k tokens, read only when the agent opens those files.

What are the alternatives to Debugging Lambda Timeouts?

Skills that share tags, products or a category with Debugging Lambda Timeouts: CRM Production Investigation Guidelines (aws/tools-for-devops-agent, 100 stars), AWS Sam Bootstrap (giuseppe-trisciuoglio/developer-kit, 355 stars), AWS Serverless Eda (zxkane/aws-skills, 367 stars) and AWS Serverless (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debugging Lambda Timeouts?

aws (a GitHub organization, an official publisher) maintains it in aws/agent-toolkit-for-aws, which has 2,825 GitHub stars. The repository holds 138 skills in this directory. The repository was last updated on October 7, 2026.

Source: aws/agent-toolkit-for-aws on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.