SkillAgentSearch skills...

aws-well-architected-review

Perform an AWS Well-Architected Framework review of the current workload IaC and architecture, generating findings and GitHub issues for improvements.

Install / Use

npx skills add github/awesome-copilot --skill aws-well-architected-review

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

98/100

Category

Automation

Supported Platforms

Universal

Our assessment of aws-well-architected-review

aws-well-architected-review scores 98/100 on our quality scale, 116th of 2,780 Automation skills we index (top 5%).

Its SKILL.md is 7.4 KB long, well organised into 24 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.

With 39,348 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
20/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so aws-well-architected-review is actively maintained.
  • Our last check on 2026-11-14 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-28. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

aws-well-architected-review compared with similar skills

All 4 of these similar skills score higher than aws-well-architected-review; compare them before choosing.

SkillScoreStarsUpdatedFormat
aws-well-architected-review (this skill)by github9839.3k53d agoSKILL.md
Agent-Reachby Panniantong100112.3k9d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install aws-well-architected-review?
Run npx skills add github/awesome-copilot --skill aws-well-architected-review. The install tabs above show the steps for each supported agent.
Which AI agents does aws-well-architected-review work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is aws-well-architected-review safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is aws-well-architected-review still maintained?
The repository was last updated about 2 months ago, so aws-well-architected-review is actively maintained.

name: aws-well-architected-review description: 'Perform an AWS Well-Architected Framework review of the current workload IaC and architecture, generating findings and GitHub issues for improvements.'

AWS Well-Architected Review

This workflow performs a structured AWS Well-Architected Framework (WAF) review against your workload's IaC files and deployed infrastructure. It identifies risks across all 6 WAF pillars and creates GitHub issues to track remediation.

Prerequisites

  • AWS CLI configured and authenticated
  • IaC files present in the repository (Terraform, CloudFormation, CDK, or SAM)
  • GitHub MCP server configured and authenticated

Workflow Steps

Step 1: Load Well-Architected Framework Reference

Fetch current AWS WAF best practices:

  • https://docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html
  • Pillar-specific lenses relevant to the workload type (Serverless, SaaS, etc.)

Step 2: Discover IaC & Architecture

Scan the repository for IaC files:

  • Terraform: **/*.tf
  • CloudFormation/SAM: **/*.yaml, **/*.json (CFn templates)
  • CDK: lib/**/*.ts, bin/**/*.ts, cdk.json

Identify key AWS services in use (compute, data, networking, security, observability) and generate a Mermaid architecture diagram.

Step 3: Pillar-by-Pillar Review

Pillar 1: Operational Excellence

  • [ ] All infrastructure defined as IaC (no manual console changes)
  • [ ] Consistent tagging strategy applied across all resources
  • [ ] CloudWatch alarms defined for key metrics
  • [ ] Automated deployment pipeline present (no manual deployments)
  • [ ] CloudTrail enabled for audit logging
  • [ ] Runbooks or operational documentation present

Pillar 2: Security

  • [ ] IAM roles use least-privilege policies (no * actions without justification)
  • [ ] No hardcoded credentials in IaC or code
  • [ ] Secrets managed via Secrets Manager or SSM Parameter Store
  • [ ] S3 buckets have public access blocked and server-side encryption enabled
  • [ ] Sensitive resources placed in private subnets
  • [ ] Security groups restrict inbound to minimum required ports/CIDRs
  • [ ] KMS encryption enabled for sensitive data stores (RDS, EBS, S3, SQS, DynamoDB)
  • [ ] SSL/TLS enforced on all endpoints (enforceSSL: true)
  • [ ] GuardDuty enabled (aws guardduty list-detectors)
  • [ ] AWS WAF configured on public-facing APIs and CloudFront distributions
  • [ ] MFA delete enabled on critical S3 buckets

Pillar 3: Reliability

  • [ ] Multi-AZ deployments for production databases (RDS Multi-AZ, DynamoDB Global Tables)
  • [ ] Auto Scaling configured with appropriate policies for EC2/ECS
  • [ ] S3 versioning and lifecycle policies configured
  • [ ] RDS automated backups enabled with appropriate retention period
  • [ ] DynamoDB Point-in-Time Recovery (PITR) enabled
  • [ ] Dead Letter Queues (DLQ) configured for Lambda, SQS, SNS
  • [ ] Route 53 health checks configured for DNS failover
  • [ ] Lambda reserved concurrency set to prevent noisy-neighbor throttling

Pillar 4: Performance Efficiency

  • [ ] Right-sized instance types (Lambda memory, EC2 type, RDS class)
  • [ ] Graviton/ARM instances used where available (Lambda arm64, EC2 Graviton)
  • [ ] Caching implemented (ElastiCache, DAX, CloudFront, API Gateway caching)
  • [ ] CloudFront used for global static content delivery
  • [ ] Aurora Serverless or DynamoDB On-Demand for variable load patterns
  • [ ] Lambda Provisioned Concurrency for latency-critical synchronous paths

Pillar 5: Cost Optimization

  • [ ] EC2 Reserved Instances or Savings Plans for steady-state workloads
  • [ ] S3 lifecycle policies moving data to cheaper storage tiers
  • [ ] Lambda arm64 architecture adopted (20% cost reduction)
  • [ ] VPC Endpoints for S3/DynamoDB to avoid NAT Gateway charges
  • [ ] gp2 EBS volumes migrated to gp3 (same performance, 20% cheaper)
  • [ ] Development/test environments have auto-shutdown schedules
  • [ ] AWS Budgets and Cost Anomaly Detection configured
  • [ ] Unattached EBS volumes and idle EC2 instances identified

Pillar 6: Sustainability

  • [ ] Graviton/ARM instances selected where available
  • [ ] Serverless/managed services preferred over always-on EC2
  • [ ] S3 lifecycle policies reduce unnecessary long-term data storage
  • [ ] Auto Scaling configured to avoid over-provisioning
  • [ ] Region selection considers AWS renewable energy commitments

Step 4: Risk Classification

For each finding, classify:

  • High Risk: Security vulnerability, single point of failure, no backup/recovery
  • Medium Risk: Suboptimal reliability, cost inefficiency, performance concern
  • Low Risk: Best practice deviation, minor optimization opportunity

Step 5: User Confirmation

🏗️ AWS Well-Architected Review Summary

📊 Review Results:
• IaC Files Analyzed: X
• AWS Services Identified: Y
• Total Findings: Z
  • High Risk: A (immediate action required)
  • Medium Risk: B (should address soon)
  • Low Risk: C (nice to have)

🔴 Top High Risk Findings:
1. [Pillar]: [Finding] — [Why it matters]
2. [Pillar]: [Finding] — [Why it matters]

💡 This will create Z individual GitHub issues + 1 EPIC issue.

❓ Proceed with creating GitHub issues? (y/n)

Step 6: Create Individual Finding Issues

Label with "well-architected" and the pillar name (e.g., "security", "reliability").

Title: [WAF-<PILLAR>] [Brief Finding] — [Risk Level]

Body:

## 🏗️ Well-Architected Finding: [Brief Title]

**Pillar**: [Name] | **Risk Level**: [High/Medium/Low] | **Effort**: [Low/Medium/High]

### 📋 Description
[Clear explanation of the finding and why it matters]

### 🔧 Remediation

**IaC Fix** (preferred):
```hcl
# Terraform example
resource "aws_s3_bucket_server_side_encryption_configuration" "example" {
  bucket = aws_s3_bucket.example.id
  rule {
    apply_server_side_encryption_by_default {
      sse_algorithm = "aws:kms"
    }
  }
}
```

**AWS CLI fallback**:
```bash
aws s3api put-bucket-encryption --bucket <name> \
  --server-side-encryption-configuration '{"Rules":[{"ApplyServerSideEncryptionByDefault":{"SSEAlgorithm":"aws:kms"}}]}'
```

### 📚 AWS Reference
- [WAF Best Practice Link]
- [AWS Documentation Link]

### ✅ Validation
- [ ] Change implemented in IaC and deployed
- [ ] AWS Config rule passes (if applicable)
- [ ] Security Hub finding resolved (if applicable)

**Well-Architected Question**: [WAF question this maps to]

Step 7: Create EPIC Tracking Issue

Label with "well-architected" and "epic".

Title: [EPIC] AWS Well-Architected Review — X findings across 6 pillars

Body: Executive summary with pillar breakdown table (finding counts by pillar and risk level), Mermaid architecture diagram, prioritized checklist linking all individual issues (High → Medium → Low), and success criteria:

  • All High-risk findings resolved
  • Medium findings have accepted mitigation plans
  • No regression in existing CloudWatch alarms or Config rules

Error Handling

  • No IaC Files Found: Limit review to live resource discovery via AWS CLI and note the gap
  • Insufficient AWS Permissions: List required read-only permissions for the review
  • GitHub Creation Failure: Output all findings as formatted markdown to console

Success Criteria

  • ✅ All 6 WAF pillars reviewed against IaC and live infrastructure
  • ✅ All findings classified by risk level and pillar
  • ✅ Actionable remediation steps with IaC examples for each finding
  • ✅ GitHub issues created for team tracking
  • ✅ Architecture diagram generated for EPIC context
  • ✅ AWS documentation references included

Related Skills

View on GitHub
GitHub Stars39.3k
CategoryAutomation
Updated1mo ago
Forks5.0k

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions