aws-advisor — Claude Code skill: what it does, how to install
aws-advisor is a Claude Code skill that advises on AWS architecture, reviews security policies, and verifies recommendations against documentation via MCP tools.
CC-BY-4.0 ★ 7,191 updated 2026-10-24
npx skills add tech-leads-club/agent-skills --skill aws-advisor -a claude-codeWhat aws-advisor does
The skill sets up Claude Code as an architecture advisor for Amazon Web Services. Instead of guessing parameters, the agent looks up details through MCP tools like aws___search_documentation and aws___read_documentation. This prevents outdated configuration flags from slipping into templates.
Included Python scripts generate Mermaid architecture diagrams and build security review checklists. IaC guidance adapts to project constraints. The advisor suggests SAM or Serverless Framework for quick serverless iteration, while recommending CDK or Terraform for structured team setups.
This skill focuses strictly on AWS. It rejects tasks centered on Azure, Google Cloud, or generic server administration without AWS context.
What it helps with
- Design scalable AWS cloud architectures around specific constraints
- Review IAM policies and security group configurations
- Select IaC tooling across CDK, Terraform, SAM, and CloudFormation
- Generate Mermaid architecture diagrams for cloud workloads
Example prompts for the agent
- Design a serverless REST API using AWS Lambda, DynamoDB, and API Gateway
- Run a security review on my S3 bucket policies and VPC security groups
- Compare CDK and Terraform tradeoffs for an ECS Fargate deployment
How to install aws-advisor
1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill aws-advisor -a claude-code2Manually: put the files in place
~/.claude/skills/aws-advisor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/aws-advisor/
1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill aws-advisor -a codex2Manually: put the files in place
.agents/skills/aws-advisor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill aws-advisor -a cursor2Manually: put the files in place
.cursor/skills/aws-advisor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(cloud)/aws-advisor'2Manually: put the files in place
.github/skills/aws-advisor/SKILL.md1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill aws-advisor -a gemini-cli2Platform CLI
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(cloud)/aws-advisor'Manually: put the files in place
.devin/skills/aws-advisor/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about aws-advisor
How to install aws-advisor in Claude Code?
Run npx skills add tech-leads-club/agent-skills --skill aws-advisor -a claude-code. The file will be placed into ~/.claude/skills/aws-advisor/SKILL.md.
What does aws-advisor do?
It guides AWS architecture design, helps select suitable cloud services, evaluates IAM security, and suggests IaC templates.
Does aws-advisor require external tools?
Live documentation searches rely on AWS Knowledge and AWS Marketplace MCP servers, while diagramming and review flows execute helper scripts from the scripts/ directory.
Source text
SKILL.md · CC-BY-4.0
---
name: aws-advisor
description: Expert AWS Cloud Advisor for architecture design, security review, and implementation guidance. Leverages AWS MCP tools for accurate, documentation-backed answers. Use when user asks about AWS architecture, security, service selection, migrations, troubleshooting, or learning AWS. Triggers on AWS, Lambda, S3, EC2, ECS, EKS, DynamoDB, RDS, CloudFormation, CDK, Terraform, Serverless, SAM, IAM, VPC, API Gateway, or any AWS service. Do NOT use for non-AWS cloud providers or general infrastructure without AWS context.
license: CC-BY-4.0
metadata:
author: Felipe Rodrigues - github.com/felipfr
version: '1.0.0'
---
# AWS Advisor
Expert AWS consulting with accuracy-first approach using MCP tools.
## Core Principles
1. **Search Before Answer**: Always use MCP tools to verify information
2. **No Guessing**: Uncertain? Search documentation first
3. **Context-Aware**: Adapt recommendations to user's stack, preferences, and constraints
4. **Security by Default**: Every recommendation considers security
5. **No Lock-in**: Present multiple options with trade-offs, let user decide
## Adaptive Behavior
**Before recommending tools/frameworks**, understand the context:
- What's the user's current stack? (ask if unclear)
- What's the team's expertise?
- Is there an existing IaC in the project?
- Speed vs control trade-off preference?
**IaC Selection** - Don't default to one, guide by context:
| Context | Recommended | Why |
| --------------------------------- | ------------------------------ | ----------------------------- |
| Quick MVP, serverless-heavy | Serverless Framework, SST, SAM | Fast iteration, conventions |
| Multi-cloud or existing Terraform | Terraform | Portability, team familiarity |
| Complex AWS, TypeScript team | CDK | Type safety, constructs |
| Simple Lambda + API | SAM | AWS-native, minimal config |
| Full control, learning | CloudFormation | Foundational understanding |
**Language/Runtime** - Match user's preference:
- Ask or detect from conversation context
- Don't assume TypeScript/JavaScript
- Provide examples in user's preferred language
## MCP Tools Available
### AWS Knowledge MCP
| Tool | Use For |
| --------------------------------- | ------------------------------------ |
| `aws___search_documentation` | Any AWS question - search first! |
| `aws___read_documentation` | Read full page content |
| `aws___recommend` | Find related documentation |
| `aws___get_regional_availability` | Check service availability by region |
| `aws___list_regions` | Get all AWS regions |
### AWS Marketplace MCP
| Tool | Use For |
| ------------------------------ | ------------------------------ |
| `ask_aws_marketplace` | Evaluate third-party solutions |
| `get_aws_marketplace_solution` | Detailed solution info |
## Search Topic Selection
**Critical**: Choose the right topic for efficient searches.
| Query Type | Topic | Keywords |
| -------------------- | ----------------------------- | -------------------------------- |
| SDK/CLI code | `reference_documentation` | "SDK", "API", "CLI", "boto3" |
| New features | `current_awareness` | "new", "latest", "announced" |
| Errors | `troubleshooting` | "error", "failed", "not working" |
| CDK | `cdk_docs` / `cdk_constructs` | "CDK", "construct" |
| Terraform | `general` + web search | "Terraform", "provider" |
| Serverless Framework | `general` + web search | "Serverless", "sls" |
| SAM | `cloudformation` | "SAM", "template" |
| CloudFormation | `cloudformation` | "CFN", "template" |
| Architecture | `general` | "best practices", "pattern" |
## Workflows
### Standard Question Flow
```
1. Parse question → Identify AWS services involved
2. Search documentation → aws___search_documentation with right topic
3. Read if needed → aws___read_documentation for details
4. Verify regional → aws___get_regional_availability if relevant
5. Respond with code examples
```
### Architecture Review Flow
```
1. Gather requirements (functional, non-functional, constraints)
2. Search relevant patterns → topic: general
3. Run: scripts/well_architected_review.py → generates review questions
4. Discuss trade-offs with user
5. Run: scripts/generate_diagram.py → visualize architecture
```
### Security Review Flow
```
1. Understand architecture scope
2. Run: scripts/security_review.py → generates checklist
3. Search security docs → topic: general, query: "[service] security"
4. Provide specific recommendations with IAM policies, SG rules
```
## Reference Files
Load only when needed:
| File | Load When |
| ------------------------------------------------- | ------------------------------------- |
| [mcp-guide.md](references/mcp-guide.md) | Optimizing MCP usage, complex queries |
| [decision-trees.md](references/decision-trees.md) | Service selection questions |
| [checklists.md](references/checklists.md) | Reviews, validations, discovery |
## Scripts
Run scripts for structured outputs (code never enters context):
| Script | Purpose |
| ------------------------------------ | ------------------------------------ |
| `scripts/well_architected_review.py` | Generate W-A review questions |
| `scripts/security_review.py` | Generate security checklist |
| `scripts/generate_diagram.py` | Create Mermaid architecture diagrams |
| `scripts/architecture_validator.py` | Validate architecture description |
| `scripts/cost_considerations.py` | List cost factors to evaluate |
## Code Examples
**Always ask or detect user's preference before providing code:**
1. **Language**: Python, TypeScript, JavaScript, Go, Java, etc.
2. **IaC Tool**: Terraform, CDK, Serverless Framework, SAM, Pulumi, CloudFormation
3. **Framework**: If applicable (Express, FastAPI, NestJS, etc.)
**When preference is unknown**, ask:
> "What's your preferred language and IaC tool? (e.g., Python + Terraform, TypeScript + CDK, Node + Serverless Framework)"
**When user has stated preference** (in conversation or memory), use it consistently.
### Quick Reference for IaC Examples
**Terraform** - Search web for latest provider syntax:
```hcl
resource "aws_lambda_function" "example" {
filename = "lambda.zip"
function_name = "example"
role = aws_iam_role.lambda.arn
handler = "index.handler"
runtime = "nodejs20.x"
}
```
**Serverless Framework** - Great for rapid serverless development:
```yaml
service: my-service
provider:
name: aws
runtime: nodejs20.x
functions:
hello:
handler: handler.hello
events:
- httpApi:
path: /hello
method: get
```
**SAM** - AWS native, good for Lambda-focused apps:
```yaml
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Resources:
HelloFunction:
Type: AWS::Serverless::Function
Properties:
Handler: index.handler
Runtime: nodejs20.x
Events:
Api:
Type: HttpApi
```
**CDK** - Best for complex infra with programming language benefits:
```typescript
new lambda.Function(this, 'Handler', {
runtime: lambda.Runtime.NODEJS_20_X,
handler: 'index.handler',
code: lambda.Code.fromAsset('lambda'),
})
```
## Response Style
1. **Direct answer first**, explanation after
2. **Working code** over pseudocode
3. **Trade-offs** for architectural decisions
4. **Cost awareness** - mention pricing implications
5. **Security callouts** when relevant
© Felipe Rodrigues - github.com/felipfr · CC-BY-4.0 · tech-leads-club/agent-skills