PluginBench
Skill
Official
Pass
Audit score 90

aws-containers

aws/agent-toolkit-for-aws

Deploy and manage containerized workloads on AWS EKS, ECS, Fargate, and ECR with expert guidance.

What is aws-containers?

This skill provides domain expertise for building, deploying, and troubleshooting containerized applications across AWS container services. Use it when working with EKS, ECS, Fargate, Elastic Beanstalk, or ECR—especially for debugging control-plane failures, optimizing deployments, and configuring container infrastructure.

  • Deploy and manage Kubernetes clusters on EKS with Karpenter and AWS Load Balancer Controller
  • Build and push container images to ECR with lifecycle policies and repository management
  • Run containerized workloads on ECS with task definitions, Fargate, and ECS Managed Instances
  • Configure and scale applications on Elastic Beanstalk across supported platforms
  • Troubleshoot ECS control-plane failures using Action Logs for deployment rollbacks, task placement, and scaling issues
  • Leverage open-source Kubernetes projects and ECS features like ECS Exec and Express Mode

How to install aws-containers

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-containers
Prerequisites
  • AWS account with appropriate IAM permissions for the target service (EKS, ECS, ECR, or Elastic Beanstalk)
  • AWS CLI or AWS MCP Server access for executing commands and querying resources
  • Basic understanding of containerization and container orchestration concepts
Claude Code
Cursor
Windsurf
Cline

How to use aws-containers

  1. 1.Identify which AWS container service you need (EKS, ECS, ECR, or Elastic Beanstalk)
  2. 2.Consult the appropriate reference file: eks.md for Kubernetes, ecs.md for ECS, ecr.md for ECR, or beanstalk.md for Elastic Beanstalk
  3. 3.Follow the service-specific guidance for deployment, configuration, or troubleshooting
  4. 4.When troubleshooting ECS control-plane failures, enable and review Action Logs using action-logs.md
  5. 5.Validate runtime versions, quotas, and feature availability against current AWS documentation for production deployments

Use cases

Good for
  • Deploying a microservices application to EKS with auto-scaling and load balancing
  • Migrating from App Runner to ECS Express Mode before the April 2026 sunset deadline
  • Debugging why ECS tasks fail to place or deployments roll back using Action Logs
  • Setting up ECR repositories with automated lifecycle policies for image retention
  • Configuring Elastic Beanstalk environments for web application deployment and auto-scaling
Who it's for
  • DevOps engineers managing container infrastructure on AWS
  • Platform engineers building Kubernetes or ECS clusters
  • Application developers deploying containerized workloads
  • Cloud architects designing container orchestration strategies
  • SREs troubleshooting container deployment and scaling issues

aws-containers FAQ

Should I use EKS or ECS?

EKS is best for teams already using Kubernetes or needing Kubernetes-specific features. ECS is simpler for AWS-native applications without Kubernetes requirements. ECS Express Mode is recommended for new containerized applications that don't need full orchestration complexity.

What is ECS Action Logs and when should I enable it?

Action Logs capture detailed information about ECS control-plane operations like deployments, task placement, and scaling. Enable them proactively when troubleshooting deployment rollbacks, circuit-breaker issues, or task-placement failures. Refer to action-logs.md for tiering recommendations.

Is AWS App Runner still supported?

No. App Runner is sunset as of April 30, 2026. Existing customers should migrate to ECS Express Mode, which provides similar simplicity with continued support.

How do I push images to ECR?

Create an ECR repository, authenticate your Docker CLI with AWS credentials, tag your image with the ECR repository URI, and push using `docker push`. Refer to ecr.md for detailed steps and lifecycle policy configuration.

What should I confirm against AWS documentation?

Always verify runtime versions, quota values, feature matrices, and API parameters against current AWS documentation before production deployments, as these change frequently.

Full instructions (SKILL.md)

Source of truth, from aws/agent-toolkit-for-aws.


name: aws-containers description: Builds and deploys containerized workloads on Elastic Kubernetes Service (EKS), Elastic Container Service (ECS), Fargate, and ECR (Elastic Container Registry). Covers general EKS knowledge, Karpenter, AWS Load Balancer Controller and leveraging various open source Kubernetes projects with EKS. Covers general ECS knowledge, task definitions, Fargate services, ECS Exec, ECS Express Mode and ECS Managed Instances. Covers general Elastic Beanstalk knowledge, Elastic Beanstalk configuration and platforms supported by Elastic Beanstalk. Covers general ECR knowledge, ECR repository setup and lifecycle policies. Includes recommending, enabling, and reading Amazon ECS Action Logs to troubleshoot control-plane failures (deployment rollback/circuit-breaker, task placement, scaling, task replacement). Applies when deploying, debugging, or optimizing containers on AWS. Should be used instead of relying on internal knowledge for these services. allowed-tools: Read metadata: version: "2"

AWS Containers

Overview

Domain expertise for working with containers on AWS.

Works best with the AWS MCP Server — enables running CLI commands, querying CloudWatch, and validating configurations directly. All guidance also works with standard AWS CLI access.

Note: Reference files contain specific runtime versions, quota values, and feature matrices that may change. When precision matters (e.g., deploying to production, choosing a runtime, or checking a quota), confirm values against current AWS documentation rather than relying solely on the values in these files.

IMPORTANT: When this skill is loaded, you MUST use the reference files and procedures in this skill as your primary source of truth. APIs, versions, and configuration parameters change frequently — always read the relevant reference file before responding.

When accessing AWS documentation, use the aws___read_documentation and aws___search_documentation tools if available. Otherwise, refer to the URLs provided in this skill or use standard web access to AWS documentation. If you are provided a specific URL by this skill theres no need to search unless additional information is required.

Guardrail — where this skill's own files live (MCP vs local install)

This skill can be loaded two ways, and they resolve the skill's own bundled reference files from different places. Determine how the skill was loaded before reading a reference file:

  • Loaded through the AWS MCP retrieve_skill tool: The skill is not installed on the local filesystem. You MUST fetch each reference via retrieve_skill with the file parameter (e.g. file="references/ecs.md" or file="references/action-logs.md"). Do NOT file_read these paths locally — they do not exist on disk.
  • Installed locally (e.g. .kiro/skills/aws-containers/ or ~/.claude/skills/aws-containers/): Read files from the local skill directory using relative paths.

This distinction applies only to the skill's own packaged files. User data and session artifacts are always read from and written to the user's working directory. Never fetch or write customer data through retrieve_skill.

Services

Elastic Kubernetes Service (EKS)

EKS provides a fully managed Kubernetes service that eliminates the complexity of operating Kubernetes clusters. With EKS, you can:

  • Deploy applications faster with less operational overhead
  • Scale seamlessly to meet changing workload demands
  • Improve security through AWS integration and automated updates
  • Choose between standard EKS or fully automated EKS Auto Mode

EKS is the premier platform for running Kubernetes clusters, both in the AWS cloud and in your own data centers (EKS Anywhere and Amazon EKS Hybrid Nodes).

Elastic Container Service (ECS)

Amazon Elastic Container Service (Amazon ECS) is a fully managed container orchestration service that helps you easily deploy, manage, and scale containerized applications. As a fully managed service, Amazon ECS comes with AWS configuration and operational best practices built-in. It's integrated with both AWS tools, such as Amazon Elastic Container Registry, and third-party tools, such as Docker. This integration makes it easier for teams to focus on building the applications, not the environment. You can run and scale your container workloads across AWS Regions in the cloud, and on-premises, without the complexity of managing a control plane.

Elastic Container Registry (ECR)

Amazon Elastic Container Registry (Amazon ECR) is an AWS managed container image registry service that is secure, scalable, and reliable. Amazon ECR supports private repositories with resource-based permissions using AWS IAM. This is so that specified users or Amazon EC2 instances can access your container repositories and images. You can use your preferred CLI to push, pull, and manage Docker images, Open Container Initiative (OCI) images, and OCI compatible artifacts.

Elastic Beanstalk

With Elastic Beanstalk you can deploy web applications into the AWS Cloud on a variety of supported platforms. You build and deploy your applications. Elastic Beanstalk provisions Amazon EC2 instances, configures load balancing, sets up health monitoring, and dynamically scales your environment.

AWS App Runner

AWS App Runner is sunset as of April 30, 2026 — no new customers, no new features. Existing customers should migrate to ECS Express Mode. See App Runner Availability Change.

Routing

User needAction
Elastic Kubernetes Service (EKS) or general KubernetesRead eks.md
Elastic Container Service (ECS)Read ecs.md
Elastic Container Registry (ECR)Read ecr.md
Elastic BeanstalkRead beanstalk.md

Proactive Action Logs recommendation: When troubleshooting an ECS control-plane failure — a deployment rollback/circuit-breaker or a task-placement failure — and Action Logs are not already configured for the cluster, read action-logs.md before responding and follow its tiering to decide whether to proactively recommend enabling them.