# AWS Step Functions

Build workflows with AWS Step Functions state machines using the JSONata query language.

- Repository: https://github.com/awslabs/agent-plugins (933 stars)
- Category: DevOps
- License: Apache-2.0
- Last updated: 2026-10-15
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add awslabs/agent-plugins --skill aws-step-functions -g -a claude-code -y`
Codex: `npx skills add awslabs/agent-plugins --skill aws-step-functions -g -a codex -y`
Cursor: `npx skills add awslabs/agent-plugins --skill aws-step-functions -g -a cursor -y`
Gemini CLI: `npx skills add awslabs/agent-plugins --skill aws-step-functions -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add awslabs/agent-plugins`

## Description

Build workflows with AWS Step Functions state machines using the JSONata query language. Covers Amazon States Language (ASL) structure, state types, variables, data transformation, error handling, AWS service integration, and migrating from the JSONPath to the JSONata query language.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AWS Step Functions

## Overview

AWS Step Functions uses Amazon States Language (ASL) to define state machines as JSON. With AWS Step Functions, you can create workflows, also called State machines, to build distributed applications, automate processes, orchestrate microservices, and create data and machine learning pipelines.

This skill provides comprehensive guidance for writing state machines in ASL, covering:

- ASL structure and JSONata expression syntax
- Details on the eight available workflow states
- The `$states` reserved variable
- Workflow variables with `Assign`
- Error handling
- AWS Service integration patterns
- Example code for data transformation and architecture
- Validation and testing of state machines
- How to migrate from JSONPath to JSONata

## When to Load Reference Files

Load the appropriate reference file based on what the user is working on:

The rest: https://github.com/awslabs/agent-plugins/blob/HEAD/plugins/aws-serverless/skills/aws-step-functions/SKILL.md