aws-serverless

Diagnose and optimize AWS serverless applications across Lambda, API Gateway, and Step Functions.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill aws-serverless-mreferre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-serverless
Source: https://github.com/mreferre/aws-agent-toolkit-skills/tree/main/.kiro/skills/aws-serverless
Command: npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill aws-serverless-mreferre

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you build reliable serverless applications on AWS by guiding correct configurations and troubleshooting common runtime and integration failures before they impact production.

Core Features & Use Cases

  • End-to-end serverless architecture guidance: Pick the right pattern for APIs, event-driven processing, orchestration, and real-time needs across Lambda, API Gateway, Step Functions, EventBridge, and triggers.
  • Deployment with SAM/CDK: Use proven resource types and deployment practices to ship faster while keeping infrastructure maintainable.
  • Performance and reliability tuning: Diagnose and improve cold starts, timeouts, throttling, concurrency, and production readiness (including observability and security hardening).
  • Practical debugging playbooks: Resolve issues like 502/504, CORS failures, event source mapping mistakes, and stream/batch error-handling edge cases with targeted reference flows.

Quick Start

Use the aws-serverless Skill to debug a Lambda-backed API error by identifying whether the root cause is a malformed proxy response, CORS headers, authorizer behavior, or an API Gateway timeout.

Frequently Asked Questions about aws-serverless

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my API Gateway return a 502 error with a Lambda backend?

Lambda proxy integration 502 errors often stem from malformed response shapes missing required statusCode, body, or headers fields, or runtime failures within the handler; verify your response structure matches API Gateway proxy requirements.

How do I fix CORS failures in AWS API Gateway and Lambda?

Resolve CORS failures by ensuring API Gateway returns proper Access-Control-Allow-Origin headers and handling OPTIONS preflight requests, while confirming Lambda proxy responses include CORS headers in both success and error paths.

How do I tune AWS Lambda concurrency and cold starts for production?

Optimize Lambda cold starts and throttling by configuring provisioned concurrency, enabling SnapStart for supported runtimes, and adjusting reserved concurrency limits to control downstream resource impact during traffic spikes.

What is the best way to troubleshoot event source mapping failures in AWS serverless apps?

Troubleshoot event source mapping by validating filtering semantics and batch size configurations for SQS, DynamoDB Streams, and SNS triggers, ensuring correct IAM permissions and handling partial batch failures properly.

How do I build event-driven architectures with Step Functions and EventBridge?

Design event-driven workflows by orchestrating Lambda functions through Step Functions state machines, routing events via EventBridge rules, and implementing reliable error handling and retry semantics across distributed services.

Can I use SAM or CDK to deploy serverless applications with API Gateway and Lambda?

Use AWS SAM or CDK to deploy serverless applications by defining infrastructure as code with proven resource types, maintaining consistent deployment patterns for API Gateway, Lambda, and event source integrations.