troubleshooting-s3-files

Diagnose S3 Files mount, IAM, sync, and VPC DNS failures.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill troubleshooting-s3-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting-s3-files
Source: https://github.com/mreferre/aws-agent-toolkit-skills/tree/main/.kiro/skills/troubleshooting-s3-files
Command: npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill troubleshooting-s3-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Troubleshooting S3 Files issues when mounts fail, permissions block access, synchronization does not update the bucket, conflicts appear, or performance is worse than expected.

Core Features & Use Cases

  • Mount and connectivity diagnosis: Identifies client installation problems, VPC/DNS misconfiguration, and security group and network rules that prevent successful mounts.
  • IAM and policy resolution: Pinpoints missing or incorrect S3 Files IAM actions (mount/write/root access) and file system policy issues that cause “creating” states or access denied errors.
  • Synchronization and conflict handling: Explains why files do not appear in S3, how export errors map to likely causes, and how to interpret lost+found conflicts.

Quick Start

Ask the assistant to troubleshoot an S3 Files mount failure in a specific region by classifying the symptom (e.g., timeout, access denied, lost+found), checking the expected IAM actions and policies, and producing the next diagnostic commands tailored to your environment.

Frequently Asked Questions about troubleshooting-s3-files

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

FAQPage Schema
How do I troubleshoot S3 Files mount failures and access denied errors?

Troubleshoot S3 Files mount failures by categorizing the symptom, validating AWS CLI compatibility, and checking IAM permissions, file system policies, and VPC DNS connectivity. This resolves access denied errors and verifies missing mount or root access actions.

Why does S3 Files fail to sync updates to my bucket and show lost+found conflicts?

S3 Files sync failures and lost+found conflicts occur when export errors map to synchronization issues. Diagnose by checking file system policies and IAM write permissions to explain why files fail to appear in S3.

What IAM permissions are required to mount S3 Files without access denied errors?

Mounting S3 Files requires specific IAM actions for mount, write, and root access. Validate these permissions and file system policies to resolve access denied errors and file systems stuck in a creating state.

How do VPC DNS and security group rules affect S3 Files connectivity?

VPC DNS misconfiguration and restrictive security group rules prevent successful S3 Files connectivity. Check network rules and AWS endpoints to diagnose client installation problems and mount timeouts.

Does S3 Files troubleshooting support KMS encryption and abnormal latency diagnosis?

S3 Files troubleshooting supports diagnosing KMS encryption issues and abnormal latency. It validates AWS endpoints and connectivity constraints to identify performance degradation and encryption access blocks.