AWS Skills for Claude Code

Claude Code plugins for AWS development with specialized knowledge and MCP server integrations, including CDK, serverless architecture, cost optimization, and Bedrock AgentCore for AI agent deployment.

Plugins

0. AWS Common Plugin (Dependency)

Shared AWS agent skills including AWS Documentation MCP configuration for querying up-to-date AWS knowledge.

Features:

• AWS MCP server configuration guide
• Documentation MCP setup for querying AWS knowledge
• Shared by all other AWS plugins as a dependency

Note: This plugin is automatically loaded as a dependency by other plugins. Install it first if installing plugins individually.

1. AWS CDK Plugin

AWS CDK development skill with integrated MCP server for infrastructure as code.

Features:

• AWS CDK best practices and patterns
• Pre-deployment validation script
• Comprehensive CDK patterns reference

Integrated MCP Server:

• AWS CDK MCP (stdio)

2. AWS Cost & Operations Plugin

Cost optimization, monitoring, and operational excellence with 3 integrated MCP servers.

Features:

• Cost estimation and optimization
• Monitoring and observability patterns
• Operational best practices

Integrated MCP Servers:

• AWS Pricing
• AWS Cost Explorer
• Amazon CloudWatch

3. AWS Serverless & Event-Driven Architecture Plugin

Serverless and event-driven architecture patterns based on Well-Architected Framework.

Features:

• Well-Architected serverless design principles
• Event-driven architecture patterns
• Orchestration with Step Functions
• Saga patterns for distributed transactions
• Event sourcing patterns

4. AWS Agentic AI Plugin

AWS Bedrock AgentCore comprehensive expert for deploying and managing AI agents.

Features:

• Gateway service for converting REST APIs to MCP tools
• Runtime service for deploying and scaling agents
• Memory service for managing conversation state
• Identity service for credential and access management
• Code Interpreter for secure code execution
• Browser service for web automation
• Observability for tracing and monitoring

Installation

Option 1: Claude Code Plugin Marketplace

Add the marketplace to Claude Code:

/plugin marketplace add zxkane/aws-skills

Install plugins individually:

# Install the common dependency first
/plugin install aws-common@aws-skills

# Then install the plugins you need
/plugin install aws-iac@aws-skills
/plugin install aws-cost-ops@aws-skills
/plugin install serverless-eda@aws-skills
/plugin install aws-agentic-ai@aws-skills

Option 2: Install Individual Skills via npx

Install a single skill directly from the repository using skills.sh:

# AWS CDK development skill
npx skills add https://github.com/zxkane/aws-skills --skill aws-cdk-development

# AWS SST (Ion) infrastructure-as-code skill
npx skills add https://github.com/zxkane/aws-skills --skill aws-sst-development

# AWS cost & operations skill
npx skills add https://github.com/zxkane/aws-skills --skill aws-cost-operations

# AWS serverless & event-driven architecture skill
npx skills add https://github.com/zxkane/aws-skills --skill aws-serverless-eda

# AWS Bedrock AgentCore skill
npx skills add https://github.com/zxkane/aws-skills --skill aws-agentic-ai

# AWS MCP setup (shared dependency)
npx skills add https://github.com/zxkane/aws-skills --skill aws-mcp-setup

Browse all skills at skills.sh/zxkane/aws-skills.

Core CDK Principles

Resource Naming

Do NOT explicitly specify resource names when they are optional in CDK constructs.

// ✅ GOOD - Let CDK generate unique names
new lambda.Function(this, 'MyFunction', {
  // No functionName specified
});

// ❌ BAD - Prevents multiple deployments
new lambda.Function(this, 'MyFunction', {
  functionName: 'my-lambda',
});

Lambda Functions

Use appropriate constructs for automatic bundling:

• TypeScript/JavaScript: NodejsFunction from aws-cdk-lib/aws-lambda-nodejs
• Python: PythonFunction from @aws-cdk/aws-lambda-python-alpha

Pre-Deployment Validation

Before committing CDK code:

npm run build
npm test
npm run lint
cdk synth
./scripts/validate-stack.sh

Usage Examples

CDK Development

Ask Claude to help with CDK:

Create a CDK stack with a Lambda function that processes S3 events

Claude will:

• Follow CDK best practices
• Use NodejsFunction for automatic bundling
• Avoid explicit resource naming
• Grant proper IAM permissions
• Use MCP servers for latest AWS information

Cost Optimization

Estimate costs before deployment:

Estimate the monthly cost of running 10 Lambda functions with 1M invocations each

Analyze current spending:

Show me my AWS costs for the last 30 days broken down by service

Monitoring and Observability

Set up monitoring:

Create CloudWatch alarms for my Lambda functions to alert on errors and high duration

Investigate issues:

Show me CloudWatch logs for my API Gateway errors in the last hour

Security and Audit

Audit activity:

Show me all IAM changes made in the last 7 days

Assess security:

Run a Well-Architected security assessment on my infrastructure

Serverless Development

Build serverless applications:

Create a serverless API with Lambda and API Gateway for user management

Implement event-driven workflow:

Create an event-driven order processing system with EventBridge and Step Functions

Orchestrate complex workflows:

Implement a saga pattern for booking flights, hotels, and car rentals with compensation logic

AI Agent Development

Deploy AI agents with Bedrock AgentCore:

Deploy a REST API as an MCP tool using AgentCore Gateway

Manage agent memory:

Set up conversation memory for my AI agent with DynamoDB backend

Monitor agent performance:

Configure observability for my AgentCore runtime with CloudWatch dashboards

Structure

.
├── .claude-plugin/
│   └── marketplace.json              # Plugin marketplace configuration
├── plugins/                          # Each plugin has isolated skills
│   ├── aws-common/
│   │   └── skills/
│   │       └── aws-mcp-setup/        # Shared MCP configuration skill
│   │           └── SKILL.md
│   ├── aws-iac/                      # Infrastructure as code (CDK + SST)
│   │   └── skills/
│   │       ├── aws-cdk-development/  # CDK development skill
│   │       │   ├── SKILL.md
│   │       │   ├── references/
│   │       │   │   └── cdk-patterns.md
│   │       │   └── scripts/
│   │       │       └── validate-stack.sh
│   │       └── aws-sst-development/  # SST v4 (Ion) IaC skill
│   │           ├── SKILL.md
│   │           └── references/
│   │               ├── authoring.md
│   │               ├── deploy-and-troubleshoot.md
│   │               └── testing.md
│   ├── aws-cost-ops/
│   │   └── skills/
│   │       └── aws-cost-operations/  # Cost & operations skill
│   │           ├── SKILL.md
│   │           └── references/
│   │               ├── operations-patterns.md
│   │               └── cloudwatch-alarms.md
│   ├── serverless-eda/
│   │   └── skills/
│   │       └── aws-serverless-eda/   # Serverless & EDA skill
│   │           ├── SKILL.md
│   │           └── references/
│   │               ├── serverless-patterns.md
│   │               └── eda-patterns.md
│   └── aws-agentic-ai/
│       └── skills/
│           └── aws-agentic-ai/       # Bedrock AgentCore skill
│               ├── SKILL.md
│               ├── services/         # Service-specific docs
│               └── cross-service/    # Cross-service patterns
└── README.md

MCP Server Names

MCP server names use short identifiers to comply with Bedrock's 64-character tool name limit. The naming pattern is: mcp__plugin_{plugin}_{server}__{tool}

Examples: awsdocs (AWS docs), cdk (CDK), cw (CloudWatch), sfn (Step Functions), sam (Serverless), etc.

Resources

• Claude Agent Skills
• AWS MCP Servers
• AWS CDK
• Amazon Bedrock AgentCore
• MCP Protocol

License

MIT License - see LICENSE

{
  "name": "aws-skills",
  "owner": {
    "name": "Kane Zhu",
    "email": "me@kane.mx"
  },
  "metadata": {
    "description": "AWS development skills for Claude Code including CDK and SST infrastructure as code, serverless architecture, cost optimization, and Bedrock AgentCore for AI agent deployment",
    "version": "2.5.0"
  },
  "plugins": [
    {
      "name": "aws-common",
      "description": "Shared AWS agent skills including AWS Documentation MCP configuration for querying up-to-date AWS knowledge",
      "version": "1.0.1",
      "author": {
        "name": "Kane Zhu",
        "email": "me@kane.mx"
      },
      "homepage": "https://github.com/zxkane/aws-skills",
      "repository": "https://github.com/zxkane/aws-skills",
      "license": "MIT",
      "keywords": [
        "aws",
        "mcp",
        "documentation",
        "common",
        "shared"
      ],
      "category": "development",
      "source": "./plugins/aws-common",
      "strict": false,
      "skills": [
        "./skills/aws-mcp-setup"
      ]
    },
    {
      "name": "aws-iac",
      "description": "AWS infrastructure-as-code skills covering both CDK (CloudFormation) and SST v4 (Pulumi/Ion): CDK best practices and Lambda workflows, plus SST resource authoring, linking, IAM scoping, deploy troubleshooting, and migration patterns",
      "version": "1.3.0",
      "author": {
        "name": "Kane Zhu",
        "email": "me@kane.mx"
      },
      "homepage": "https://github.com/zxkane/aws-skills",
      "repository": "https://github.com/zxkane/aws-skills",
      "license": "MIT",
      "keywords": [
        "aws",
        "cdk",
        "sst",
        "ion",
        "pulumi",
        "lambda",
        "infrastructure",
        "iac",
        "cloud",
        "skills"
      ],
      "category": "development",
      "source": "./plugins/aws-iac",
      "strict": false,
      "skills": [
        "./skills/aws-cdk-development",
        "./skills/aws-sst-development"
      ]
    },
    {
      "name": "aws-cost-ops",
      "description": "AWS cost optimization, monitoring, and operational excellence with integrated MCP servers for billing, cost analysis, observability, and security assessment",
      "version": "1.2.1",
      "author": {
        "name": "Kane Zhu",
        "email": "me@kane.mx"
      },
      "homepage": "https://github.com/zxkane/aws-skills",
      "repository": "https://github.com/zxkane/aws-skills",
      "license": "MIT",
      "keywords": [
        "aws",
        "cost",
        "billing",
        "monitoring",
        "cloudwatch",
        "operations",
        "observability"
      ],
      "category": "operations",
      "source": "./plugins/aws-cost-ops",
      "strict": false,
      "skills": [
        "./skills/aws-cost-operations"
      ],
      "mcpServers": {
        "pricing": {
          "type": "stdio",
          "command": "uvx",
          "args": [
            "awslabs.aws-pricing-mcp-server@latest"
          ],
          "env": {
            "FASTMCP_LOG_LEVEL": "ERROR"
          }
        },
        "billing": {
          "type": "stdio",
          "command": "uvx",
          "args": [
            "awslabs.billing-cost-management-mcp-server@latest"
          ],
          "env": {
            "FASTMCP_LOG_LEVEL": "ERROR"
          }
        },
        "cw": {
          "type": "stdio",
          "command": "uvx",
          "args": [
            "awslabs.cloudwatch-mcp-server@latest"
          ],
          "env": {
            "FASTMCP_LOG_LEVEL": "ERROR"
          }
        }
      }
    },
    {
      "name": "serverless-eda",
      "description": "AWS serverless and event-driven architecture best practices based on Well-Architected Framework with MCP servers for SAM, Lambda, Step Functions, and messaging",
      "version": "1.2.1",
      "author": {
        "name": "Kane Zhu",
        "email": "me@kane.mx"
      },
      "homepage": "https://github.com/zxkane/aws-skills",
      "repository": "https://github.com/zxkane/aws-skills",
      "license": "MIT",
      "keywords": [
        "aws",
        "serverless",
        "lambda",
        "event-driven",
        "eda",
        "step-functions",
        "eventbridge",
        "sqs",
        "sns"
      ],
      "category": "development",
      "source": "./plugins/serverless-eda",
      "strict": false,
      "skills": [
        "./skills/aws-serverless-eda"
      ]
    },
    {
      "name": "aws-agentic-ai",
      "description": "AWS Bedrock AgentCore comprehensive expert for deploying and managing all AgentCore services including Gateway, Runtime, Memory, Identity, Code Interpreter, Browser, Observability, Agent Registry, and Evaluations",
      "version": "1.4.0",
      "author": {
        "name": "Kane Zhu",
        "email": "me@kane.mx"
      },
      "homepage": "https://github.com/zxkane/aws-skills",
      "repository": "https://github.com/zxkane/aws-skills",
      "license": "MIT",
      "keywords": [
        "aws",
        "bedrock",
        "agentcore",
        "ai-agents",
        "mcp",
        "gateway",
        "runtime",
        "memory",
        "identity",
        "agent-registry",
        "discovery",
        "evaluations"
      ],
      "category": "development",
      "source": "./plugins/aws-agentic-ai",
      "strict": false,
      "skills": [
        "./skills/aws-agentic-ai"
      ],
      "mcpServers": {
        "acdocs": {
          "type": "stdio",
          "command": "uvx",
          "args": [
            "awslabs.amazon-bedrock-agentcore-mcp-server@latest"
          ],
          "env": {
            "FASTMCP_LOG_LEVEL": "ERROR"
          }
        }
      }
    }
  ]
}