skills.rest
nsuberi
nsuberiCOMMUNITY
Explore all skills by this author →
GitHub

debug-aws

Diagnose and resolve AWS infrastructure failures across S3, CloudFront, ECS, Lambda, and RDS.

Updated Jul 5, 2025
Search Tags:#troubleshooting#aws#terraform#ecs#rds#lambda#cloudfront
One-click install
npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill debug-aws
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug-aws
Source: https://github.com/nsuberi/proto-portal-showcase-hub/tree/main/.claude/skills/debug-aws
Command: npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill debug-aws

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a systematic, service-by-service troubleshooting workflow to diagnose and remediate AWS infrastructure issues affecting the portfolio deployment, reducing downtime and accelerating recovery for S3/CloudFront static site, ECS Fargate services, Lambda/API Gateway endpoints, RDS databases, and DNS/certificate problems.

Core Features & Use Cases

  • Service identification: Maps observed symptoms (HTTP codes, DNS failures, task stops) to the most likely AWS service to inspect.
  • Targeted diagnostics: Prescribes AWS CLI commands, CloudWatch checks, ALB/target health, ECS task logs, RDS status checks, ACM/Route53 validation, and Terraform state troubleshooting steps.
  • Operational playbooks: Includes common fixes such as CloudFront invalidation, forcing ECS redeployments, checking Secrets Manager permissions, and resolving Terraform state drift.
  • Use case: If /ai-evals returns 502, follow ECS and ALB health checks, inspect container logs and ECR images, verify IAM and security group connectivity, and redeploy or scale tasks as indicated.

Quick Start

Diagnose why the portfolio site is returning 502 errors for /ai-evals and request step-by-step AWS CLI checks, log locations, and remediation instructions.

Frequently Asked Questions about debug-aws

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot ECS Fargate task failures and ALB 502 errors in AWS?▼

Troubleshoot ECS Fargate 502 errors by running AWS CLI checks on ALB target health, inspecting ECS task stop logs in CloudWatch, verifying ECR images, and forcing a redeployment if containers fail to start.

Why does my RDS database connectivity fail when using AWS Secrets Manager?▼

RDS connectivity fails when IAM policies block Secrets Manager access or security groups restrict traffic; verify IAM permissions to inspect secrets, check RDS status via AWS CLI, and validate security group rules to remediate.

How do I resolve Terraform state drift and module errors in AWS?▼

Resolve Terraform state drift by accessing Terraform state outputs, inspecting resource divergence with AWS CLI, and reconciling module configurations to align deployed AWS infrastructure with expected state.

What is the best way to fix CloudFront and S3 static site deployment issues?▼

Fix CloudFront and S3 static site issues by running CloudFront diagnostics, checking S3 bucket policies, validating ACM certificates and Route53 DNS, and performing CloudFront cache invalidation to clear stale content.

Do I need AWS CLI and IAM permissions to diagnose Lambda and API Gateway errors?▼

Yes, diagnosing Lambda and API Gateway errors requires AWS CLI or SDKs with sufficient IAM permissions to inspect CloudWatch logs, trace execution failures, and verify endpoint configurations.

How do I fix AWS outages when my portfolio deployment returns HTTP errors?▼

Fix AWS outages by mapping HTTP error codes to the affected service, executing targeted AWS CLI diagnostics for ECS or CloudFront, and applying operational playbooks like forcing redeployments or invalidating caches.

Related Skills

Explore More Software Engineering Skills→
ToanPV90ToanPV90

aws-secrets-manager

Store and rotate sensitive credentials in AWS Secrets Manager.

Community
Advanced
different-aidifferent-ai
249

vercel-dns

Automate DNS record operations for Vercel-hosted domains via the Vercel CLI.

Official
Advanced
ToanPV90ToanPV90

aws-ecs-fargate

Deploys containerized apps to AWS ECS Fargate with ALB load balancing and CloudWatch logging.

Community
Advanced
snoodleboot-iosnoodleboot-io
2

infrastructure-drift-detection

Compare current infrastructure configurations against baseline configurations to detect drift.

Official
Advanced