aws-skills - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #android #rust #macos #windows #awesome #awesome-list #pytorch #security #mcp #ios #open-source

aws-skills

(★ 351)

Claude Code plugins and agent skills for AWS development — IaC(CDK/SST), serverless, cost ops, and Bedrock AgentCore

File Explorer

Download Latest Version (.zip)

- - aws-agentic-ai
  - aws-cdk-development
  - aws-cost-operations
  - aws-mcp-setup
  - aws-serverless-eda
  - aws-sst-development
- settings.json
- marketplace.json
- - validate.yml
- aws-mcp-setup.md
- - validate_marketplace.py
.gitignore
CLAUDE.md
LICENSE
README.md

# Installation Guide

1. Get the code

git clone https://github.com/zxkane/aws-skills

Downloads the entire project code from GitHub to your computer.

cd aws-skills

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

⚠️ This is a large repository, so this method may point to an internal sub-package rather than the actual core product. Check the full README as well.

docker build -f plugins/aws-agentic-ai/skills/aws-agentic-ai/scripts/Dockerfile.runtime-template -t aws-skills .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 aws-skills

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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:

```bash
/plugin marketplace add zxkane/aws-skills
```

Install plugins individually:

```bash
# 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](https://skills.sh):

```bash
# 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](https://skills.sh/zxkane/aws-skills).

## Core CDK Principles

### Resource Naming

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

```typescript
// ✅ 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:

```bash
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](https://docs.claude.com/en/docs/claude-code/skills)
- [AWS MCP Servers](https://awslabs.github.io/mcp/)
- [AWS CDK](https://aws.amazon.com/cdk/)
- [Amazon Bedrock AgentCore](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html)
- [MCP Protocol](https://modelcontextprotocol.io/)

## License

MIT License - see [LICENSE](LICENSE)