AWS Troubleshooting Skill

aws-troubleshoot

Troubleshoot AWS services using tool-first access (via MCP when available), falling back to AWS CLI when necessary. Focus on EKS, S3, ECR, EC2, SSM, networking, site-to-site VPNs, IAM Identity Center, and IAM.

majiayu000/claude-skill-registry·0installs663starsSecurity

SKILL.md

Full skill instructions

AWS Troubleshooting Skill

General Guidance

Always use tool access first for logs, metrics, and audit events.
Fallback to AWS CLI commands only when deeper inspection is required or the tool cannot access specific data.

All investigations should:

Scope log queries by log group and time window
Check CloudTrail for failed API calls
Use service-specific metrics before guessing
Recommend minimal corrections

Core Services Covered

EKS

Common issues:

Image pull errors
Pod pending (CNI/IP exhaustion)
CrashLoopBackOff
Node NotReady

Investigations:

Query pod logs
Query pod events
Inspect node status and cluster metrics

S3

Common issues:

AccessDenied
Incorrect KMS key
BlockPublicAccess conflicts

Investigations:

Query S3 server access logs
Inspect CloudTrail for denied events

ECR

Common issues:

Token expiration
Missing permissions
Architecture mismatch

Investigations:

Search CloudTrail for ecr:* denied actions
Inspect repository push/pull failures

EC2

Common issues:

Failed instance boot
ENI/network issues
IMDSv2 access failures

Investigations:

Check EC2 instance status checks
Inspect system logs and VPC configuration

SSM (Systems Manager)

SSM commands can be performed through the AWS tool when available.

Common issues:

Agent not running
Missing IAM permissions
Instance not registered
Command execution failures

Investigations:

Check SSM agent status on instances
Query command execution history
Inspect CloudTrail for SSM API failures
Validate instance profile permissions

Networking & VPN

Common issues:

Route mismatches
NACL/Security Group blocks
VPN tunnel down

Investigations:

Query CloudWatch metrics for VPN TunnelState
Validate routing tables and security groups

IAM Identity Center (SSO)

Common issues:

User not assigned
Permission set mismatch

Investigations:

Inspect activity logs for SSO authentication issues
Validate permission sets

IAM

Common issues:

AccessDenied
Incorrect role assumption

Investigations:

Query CloudTrail for denied API events
Identify missing permissions

Workflow

Identify service
Query scoped logs
Query CloudTrail for denied API calls
Query metrics when relevant
Diagnose using AWS-specific heuristics
Provide safe remediation steps

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/majiayu000/claude-skill-registry --skill aws-troubleshoot

View on GitHub

skills/data/aws-troubleshoot/SKILL.md

More Security skills

View all

Security

supabase

Handles the full Supabase workflow from schema changes to deployment, with built-in security guardrails that catch common traps like RLS...

2.7K 308.9K

View

Security

neon-postgres

Comprehensive guides and best practices for Neon Serverless Postgres, covering setup, connection methods, authentication, and platform APIs.

98 216.2K

View

Security

firebase-auth-basics

Guide for setting up and using Firebase Authentication. Use this skill when the user's app requires user sign-in, user management, or secure data access using auth rules.

462 163.8K

View

Security

firebase-security-rules-auditor

A skill to evaluate how secure Firestore security rules are. Use this when Firestore security rules are updated to ensure that the generated rules are extremely secure and robust.

462 127.7K

View

Security

firebase-ai-logic-basics

Official skill for integrating Firebase AI Logic (Gemini API) into web applications. Covers setup, multimodal inference, structured output, and security.

462 125.1K

View

Security

better-auth-best-practices

Complete Better Auth server and client setup with database adapters, session management, plugins, and security configuration.

222 118.2K

View

Security

vercel-cli-with-tokens

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

31.9K 116.1K

View

Security

cloudflare

Complete Cloudflare platform integration with decision trees for compute, storage, AI, networking, security, and infrastructure-as-code.

3K 110.7K

View

Security

azure-compliance

Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.

253 103K

View