View a markdown version of this page

Agent setup guide - AWS Step Functions

Agent setup guide

AI coding agents can accelerate serverless development by providing intelligent assistance for application scaffolding, deployment configuration, debugging, and infrastructure-as-code generation. By configuring your agent with the right combination of plugins and skills, you equip it with expertise required to build and manage serverless applications.

Work with your coding agent

For a quick-start reference, you can drop this link directly into your agent's context: https://docs.aws.amazon.com/step-functions/latest/dg/samples/aws-sfn-agent-setup.md

Choose the installation method that matches your development environment.

Prerequisites

Ensure the following prerequisites are in place for installing the aws-core plugin:

  • uv installed on your system.

  • (Optional) An AWS account with IAM credentials set up on your local machine. Credentials are required for tools that execute AWS API calls and run scripts, but not for searching documentation or discovering skills. If you do not have credentials configured, see Setting up the AWS MCP Server for detailed instructions.

Claude Code

Install the aws-core plugin, part of the Agent Toolkit for AWS, that bundles the AWS MCP Server configuration and a curated set of agent skills (including the AWS serverless skill).

Install aws-core plugin from Agent Toolkit for AWS

Run the following command to install the plugin:

/plugin marketplace add aws/agent-toolkit-for-aws /plugin install aws-core@agent-toolkit-for-aws

This installs agent skills including the AWS serverless skill, agent hooks, and the AWS MCP Server configuration in one step.

Codex

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Cursor

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Kiro

Install AWS serverless skill in Kiro CLI

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Kiro powers (from Kiro IDE)

Install the following Kiro powers that provide specialized contexts and tools to the Kiro agents on-demand:

GitHub Copilot

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Windsurf

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

OpenCode

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

For all other agents compatible with agent skills

For any other agent that supports the open-source agent skills format, follow these steps:

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global