AWS Specialist
Structured investigation for AWS workloads. Five phases: gather context,
diagnose, design, recommend, verify.
Arguments
$0 — account context, service scope, or problem description. Required.
Phase 1: Context Gathering
- Identify the account(s), region(s), and services in scope.
- Glob for IaC in the working directory:
**/*.tf, **/*.yaml (SAM/CloudFormation), **/cdk.json, **/template.yaml.
- If AWS CLI access is available:
aws sts get-caller-identity
aws configure list
- Note the service scope (e.g. "EKS cluster + VPC + IAM" vs "Lambda + API Gateway + DynamoDB"). Scope commands to the relevant resource types.
Phase 2: Diagnosis
Compute / containers:
aws ec2 describe-instances --filters Name=instance-state-name,Values=running
aws ecs list-services --cluster <name>
aws eks describe-cluster --name <name>
IAM / identity:
aws iam list-policies --scope Local
aws iam get-role --role-name <role>
aws iam simulate-principal-policy --policy-source-arn <arn> --action-names <action>
Networking:
aws ec2 describe-vpcs
aws ec2 describe-route-tables
aws ec2 describe-security-groups
Serverless / events:
aws lambda list-functions
aws lambda get-function-configuration --function-name <name>
aws apigateway get-rest-apis
Cost / quotas:
aws service-quotas list-service-quotas --service-code ec2
aws ce get-cost-and-usage --time-period Start=<>,End=<> --granularity DAILY --metrics UnblendedCost
Phase 3: Design / Root-Cause Analysis
Map symptoms to causes:
| Symptom |
Common Causes |
Check |
| 5xx from ALB |
Unhealthy targets, timeout mismatch, HTTP/S misrouting |
Target group health, ALB access logs |
| Lambda throttled |
Reserved concurrency, account-wide limit |
aws lambda get-function-concurrency |
| EKS pod IAM fails |
Missing IRSA, ServiceAccount annotation |
OIDC provider + trust policy on role |
| S3 AccessDenied |
Bucket policy, SCP, VPC endpoint policy |
Use aws s3api get-bucket-policy + IAM simulator |
| RDS CPU spike |
Missing indexes, connection storm, runaway query |
Performance Insights, slow query log |
| CloudFront caching miss |
Incorrect cache key, missing Cache-Control |
Check behaviors + origin headers |
Cite resource ARN or file:line for every finding.
Phase 4: Recommendations
Output findings in priority order:
[CRITICAL] <title>
Resource: <ARN or file:line>
Issue: <one sentence>
Evidence: <CLI output or code snippet>
Fix: <specific change, with IaC diff if applicable>
Trade-off: <alternative and its downside, if meaningful>
- Order: CRITICAL → WARNING → INFO.
- For IaC fixes, show the exact Terraform/CDK/CloudFormation diff.
- Reference relevant docs in
references/ where applicable.
Phase 5: Verification
After fixes are applied:
- Re-run the diagnostic command that surfaced the issue.
- For IAM changes:
aws iam simulate-principal-policy with the exact action and resource.
- For networking changes:
aws ec2 describe-route-tables or VPC Reachability Analyzer.
- For serverless changes: invoke a test event via
aws lambda invoke or API Gateway test console.
- Check CloudWatch metrics and alarms — no new alarms should be triggering.
Reference Docs
Consult references/ for decision guides:
| File |
When to use |
compute.md |
EC2, ECS, EKS selection and sizing |
serverless.md |
Lambda, API Gateway, EventBridge, SQS, SNS |
storage.md |
S3, EBS, EFS, RDS, DynamoDB |
networking.md |
VPC, ALB/NLB, Route53, CloudFront, PrivateLink |
iam.md |
Policies, roles, SCPs, permission boundaries |
observability.md |
CloudWatch, X-Ray, Container Insights |
iac-patterns.md |
CloudFormation, CDK, SAM patterns |
1---2# dotbabel:generated projection=sha256:388eecd762f062c54f24ead8ae0509e0ecc0d47b63e6ca26f62f047382e067de source=skills/aws-specialist/SKILL.md — do not edit directly3allowed-tools: Read Grep Glob Bash4argument-hint: <account context, service, or problem description>5description: |6 Deep-dive AWS architecture review, debugging, and service design. Use for structured investigations of AWS-specific issues, cost or IAM audits, and multi-service design reviews. Triggers on: "AWS audit", "AWS design review", "IAM review", "cost audit AWS", "review my VPC", "AWS troubleshooting", "Lambda deep-dive".7name: aws-specialist-38metadata:9 source: https://skillmd.com/skills/kaiohenricunha/aws-specialist-310---1112# AWS Specialist1314Structured investigation for AWS workloads. Five phases: gather context,15diagnose, design, recommend, verify.1617## Arguments1819- `$0` — account context, service scope, or problem description. Required.2021---2223## Phase 1: Context Gathering24251. Identify the account(s), region(s), and services in scope.262. Glob for IaC in the working directory: `**/*.tf`, `**/*.yaml` (SAM/CloudFormation), `**/cdk.json`, `**/template.yaml`.273. If AWS CLI access is available:28 ```bash29 aws sts get-caller-identity30 aws configure list31 ```324. Note the service scope (e.g. "EKS cluster + VPC + IAM" vs "Lambda + API Gateway + DynamoDB"). Scope commands to the relevant resource types.3334---3536## Phase 2: Diagnosis3738**Compute / containers:**3940```bash41aws ec2 describe-instances --filters Name=instance-state-name,Values=running42aws ecs list-services --cluster <name>43aws eks describe-cluster --name <name>44```4546**IAM / identity:**4748```bash49aws iam list-policies --scope Local50aws iam get-role --role-name <role>51aws iam simulate-principal-policy --policy-source-arn <arn> --action-names <action>52```5354**Networking:**5556```bash57aws ec2 describe-vpcs58aws ec2 describe-route-tables59aws ec2 describe-security-groups60```6162**Serverless / events:**6364```bash65aws lambda list-functions66aws lambda get-function-configuration --function-name <name>67aws apigateway get-rest-apis68```6970**Cost / quotas:**7172```bash73aws service-quotas list-service-quotas --service-code ec274aws ce get-cost-and-usage --time-period Start=<>,End=<> --granularity DAILY --metrics UnblendedCost75```7677---7879## Phase 3: Design / Root-Cause Analysis8081Map symptoms to causes:8283| Symptom | Common Causes | Check |84| ----------------------- | ------------------------------------------------------ | ------------------------------------------------- |85| 5xx from ALB | Unhealthy targets, timeout mismatch, HTTP/S misrouting | Target group health, ALB access logs |86| Lambda throttled | Reserved concurrency, account-wide limit | `aws lambda get-function-concurrency` |87| EKS pod IAM fails | Missing IRSA, ServiceAccount annotation | OIDC provider + trust policy on role |88| S3 AccessDenied | Bucket policy, SCP, VPC endpoint policy | Use `aws s3api get-bucket-policy` + IAM simulator |89| RDS CPU spike | Missing indexes, connection storm, runaway query | Performance Insights, slow query log |90| CloudFront caching miss | Incorrect cache key, missing `Cache-Control` | Check behaviors + origin headers |9192Cite resource ARN or `file:line` for every finding.9394---9596## Phase 4: Recommendations9798Output findings in priority order:99100```101[CRITICAL] <title>102Resource: <ARN or file:line>103Issue: <one sentence>104Evidence: <CLI output or code snippet>105Fix: <specific change, with IaC diff if applicable>106Trade-off: <alternative and its downside, if meaningful>107```108109- Order: CRITICAL → WARNING → INFO.110- For IaC fixes, show the exact Terraform/CDK/CloudFormation diff.111- Reference relevant docs in `references/` where applicable.112113---114115## Phase 5: Verification116117After fixes are applied:1181191. Re-run the diagnostic command that surfaced the issue.1202. For IAM changes: `aws iam simulate-principal-policy` with the exact action and resource.1213. For networking changes: `aws ec2 describe-route-tables` or VPC Reachability Analyzer.1224. For serverless changes: invoke a test event via `aws lambda invoke` or API Gateway test console.1235. Check CloudWatch metrics and alarms — no new alarms should be triggering.124125---126127## Reference Docs128129Consult `references/` for decision guides:130131| File | When to use |132| ------------------ | ---------------------------------------------- |133| `compute.md` | EC2, ECS, EKS selection and sizing |134| `serverless.md` | Lambda, API Gateway, EventBridge, SQS, SNS |135| `storage.md` | S3, EBS, EFS, RDS, DynamoDB |136| `networking.md` | VPC, ALB/NLB, Route53, CloudFront, PrivateLink |137| `iam.md` | Policies, roles, SCPs, permission boundaries |138| `observability.md` | CloudWatch, X-Ray, Container Insights |139| `iac-patterns.md` | CloudFormation, CDK, SAM patterns |