packages/skills-catalog/skills/(cloud)/aws-advisor/SKILL.md
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.
npx skillsauth add tech-leads-club/agent-skills aws-advisorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Expert AWS consulting with accuracy-first approach using MCP tools.
Before recommending tools/frameworks, understand the context:
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:
| 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 |
| Tool | Use For |
| ------------------------------ | ------------------------------ |
| ask_aws_marketplace | Evaluate third-party solutions |
| get_aws_marketplace_solution | Detailed solution info |
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" |
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
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
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
Load only when needed:
| File | Load When | | ------------------------------------------------- | ------------------------------------- | | mcp-guide.md | Optimizing MCP usage, complex queries | | decision-trees.md | Service selection questions | | checklists.md | Reviews, validations, discovery |
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 |
Always ask or detect user's preference before providing code:
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.
Terraform - Search web for latest provider syntax:
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:
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:
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:
new lambda.Function(this, 'Handler', {
runtime: lambda.Runtime.NODEJS_20_X,
handler: 'index.handler',
code: lambda.Code.fromAsset('lambda'),
})
development
Generate Excalidraw diagrams from natural language descriptions. Outputs .excalidraw JSON files openable in Excalidraw. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", "generate an Excalidraw file", "draw an ER diagram", "create a sequence diagram", or "make a class diagram". Supports flowcharts, relationship diagrams, mind maps, architecture, DFD, swimlane, class, sequence, and ER diagrams. Can use icon libraries (AWS, GCP, etc.) when set up. Do NOT use for code architecture analysis (use the architecture skills), Mermaid diagram rendering (use mermaid-studio), or non-visual documentation (use docs-writer).
tools
Browser debugging, performance profiling, and automation via Chrome DevTools MCP. Use when user says "debug this page", "take a screenshot", "check network requests", "profile performance", "inspect console errors", or "analyze page load". Do NOT use for full E2E test suites (use playwright-skill) or non-browser debugging.
development
Repository-grounded threat modeling that enumerates trust boundaries, assets, attacker capabilities, abuse paths, and mitigations, and writes a concise Markdown threat model. Use when the user asks to threat model a codebase or path, enumerate threats or abuse paths, or perform AppSec threat modeling. Do NOT use for general architecture summaries, code review, security best practices (use security-best-practices), or non-security design work.
development
Analyze git repositories to build a security ownership topology (people-to-file), compute bus factor and sensitive-code ownership, and export CSV/JSON for graph databases and visualization. Use when the user explicitly wants a security-oriented ownership or bus-factor analysis grounded in git history (for example: orphaned sensitive code, security maintainers, CODEOWNERS reality checks for risk, sensitive hotspots, or ownership clusters). Do NOT use for general maintainer lists, non-security ownership questions, or threat modeling (use security-threat-model).