Troubleshooting S3 Files

This handles the full diagnostic spectrum for Amazon S3 Files, from mount failures and security group misconfigurations to IAM permission errors and sync problems. It's structured as a decision tree that classifies symptoms into nine categories, then walks through fixes with actual commands. The most useful part is probably the security group troubleshooting, since connection timeouts are apparently the number one mount failure. It also covers the less obvious gotchas like file systems stuck in "creating" status due to bad IAM roles, and why DNS resolution fails in VPCs. Good for anyone running S3 Files in production who needs to debug issues methodically rather than guessing.

skills.sh installs: 6.7K
GitHub stars: 3.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aws/agent-toolkit-for-aws --skill troubleshooting-s3-files --agent claude-code

Installs into .claude/skills of the current project.

Files

Troubleshooting S3 Files

Overview

Diagnoses and resolves Amazon S3 Files issues: mount failures, IAM permissions, synchronization, conflict resolution, and performance.

For authoritative guidance, see S3 Files Troubleshooting.

Common Tasks

0. Verify Dependencies

You MUST verify aws CLI is available with s3files subcommand support
You MUST confirm valid AWS credentials
You MUST ONLY check for tool existence and version — MUST NOT execute destructive or mutating commands during verification
You MUST inform the user if any required tools are missing
You MUST respect the user's decision to abort if tools are unavailable
You SHOULD explain steps before executing and wait for user confirmation on write commands