How does this skill stay up to date?

It uses WebFetch to retrieve the latest 'AWS_LEARNINGS.md' document from a remote repository, ensuring the advice reflects current best practices and newly discovered issues.

Can I use this with Terraform or CDK?

Yes, while the primary focus is often CloudFormation and CDK, the architectural logic applies to SAM, Terraform, and even manual configuration reviews.

What is the AWS Architecture Gotchas skill?

It is a specialized Claude Code skill that reviews your AWS infrastructure code against a database of known pitfalls to prevent common deployment errors.

How does it help with IAM security?

It identifies common mistakes in IAM role management across stacks and helps ensure that permissions are correctly scoped for services like Lambda and S3.

Which AWS services are covered by this skill?

The skill provides guidance for API Gateway, Lambda, IAM, S3, CloudFront, CloudFormation, Secrets Manager, EC2, and SSM.

AWS Architecture Gotchas

Name: AWS Architecture Gotchas
Author: jbdamask

byjbdamask

•

Infraestructura en la Nube

Prevents common AWS infrastructure mistakes by applying real-world deployment lessons to CloudFormation, CDK, and serverless components.

AWS Architecture Gotchas acts as a proactive architectural advisor that helps developers avoid expensive and time-consuming deployment errors. By fetching and analyzing a curated set of hard-won lessons from real-world AWS environments, this skill identifies subtle pitfalls in API Gateway configurations, Lambda handler paths, IAM policies, and cross-stack references. It is an essential tool for cloud engineers and developers who want to ensure their Infrastructure-as-Code templates adhere to proven patterns and avoid the common 'gotchas' that often disrupt production releases.

Características Principales

01Checks for cross-stack CloudFormation references and exports

02Dynamic fetching of the latest documented architectural best practices

034 GitHub stars

04Proactive identification of common AWS service misconfigurations

05Comprehensive validation for Lambda, API Gateway, and IAM

06Contextual citations of lessons learned for better decision-making

Casos de Uso

01Troubleshooting complex API Gateway CORS and Lambda integration issues

02Validating secure S3 bucket policies and CloudFront distribution settings

03Reviewing CloudFormation or CDK templates before initial deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jbdamask/john-claude-skills aws-architecture-gotchas

For use in Claude.ai and ChatGPT

Download Skill