aws-troubleshoot

Troubleshoot AWS service issues using scoped log queries and CloudTrail checks.

1|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/timbuchinger/loadout --skill aws-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-troubleshoot
Source: https://github.com/timbuchinger/loadout/tree/main/skills/aws-troubleshoot
Command: npx skills add https://github.com/timbuchinger/loadout --skill aws-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies and accelerates troubleshooting across various AWS services by guiding you through a systematic, tool-first diagnostic process. It helps you quickly pinpoint root causes and recommend minimal, safe corrections.

Core Features & Use Cases

  • Service-Specific Diagnostics: Provides targeted troubleshooting for EKS, S3, ECR, EC2, networking, IAM, and more.
  • Tool-First Approach: Prioritizes using efficient tool-based access (e.g., MCP) for logs, metrics, and audit events, falling back to AWS CLI only when necessary.
  • Systematic Workflow: Guides through identifying the service, querying scoped logs/metrics/CloudTrail, diagnosing, and suggesting remediation.
  • Use Case: Your EKS pods are stuck in CrashLoopBackOff. This Skill helps you query pod logs and events, inspect node status, and identify the underlying issue without sifting through endless documentation.

Quick Start

Troubleshoot why my S3 bucket is returning 'AccessDenied' errors for a specific user, checking CloudTrail logs.

Frequently Asked Questions about aws-troubleshoot

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

FAQPage Schema
How do I troubleshoot AWS service errors like EKS pod failures or S3 access denied issues?

Troubleshoot AWS service errors by identifying the affected service, then systematically querying scoped logs, CloudTrail audit events, and service metrics to pinpoint root causes. This Skill guides you through a tool-first diagnostic workflow for EKS, S3, EC2, ECR, IAM, and networking, reducing time spent searching documentation.

Can I check CloudTrail logs for denied API calls to diagnose IAM permission issues?

Yes. CloudTrail checks reveal denied API calls and authentication failures, helping diagnose IAM and IAM Identity Center permission problems. This Skill automates scoped CloudTrail queries by time window and service to surface the exact policy or credential issue blocking access.

What's the fastest way to diagnose EKS pod crashes and node status problems?

Query pod logs and Kubernetes events, then inspect node metrics and status—this Skill systematically guides you through this workflow using tool-first access to logs and metrics, pinpointing whether crashes stem from pod configuration, node capacity, or networking issues without manual log sifting.

How do I use service metrics to troubleshoot EC2, S3, or networking performance issues?

Leverage service metrics alongside scoped log queries and CloudTrail checks to correlate performance anomalies with API activity and configuration changes. This Skill applies metric-driven investigation to EC2, S3, site-to-site VPNs, and networking to isolate the root cause quickly.

Does this approach work for troubleshooting IAM Identity Center and SSM issues?

Yes. This Skill covers IAM Identity Center and Systems Manager troubleshooting by querying relevant logs, metrics, and CloudTrail events. The tool-first, service-scoped diagnostic process applies across all supported AWS services listed in the metadata.