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.
npx skills add github/awesome-copilot --skill aws-well-architected-review --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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)
- Prerequisites
- Workflow Steps
- Step 1: Load Well-Architected Framework Reference
- Step 2: Discover IaC & Architecture
- Step 3: Pillar-by-Pillar Review
- Step 4: Risk Classification
- Step 5: User Confirmation
- Step 6: Create Individual Finding Issues
- Step 7: Create EPIC Tracking Issue
- Error Handling
- Success Criteria
What does the aws-well-architected-review skill do?
Perform an AWS Well-Architected Framework review of the current workload IaC and architecture, generating findings and GitHub issues for improvements.
How do I install it?
Run `npx skills add github/awesome-copilot --skill aws-well-architected-review --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.