troubleshooting-s3-files

Diagnose and remediate Amazon S3 Files mount, permission, sync, and performance issues.

2.3k|234|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill troubleshooting-s3-files-aws
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting-s3-files
Source: https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/storage-skills/troubleshooting-s3-files
Command: npx skills add https://github.com/aws/agent-toolkit-for-aws --skill troubleshooting-s3-files-aws

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and resolves Amazon S3 Files issues including mount failures, IAM permissions, synchronization problems, and performance issues. Use when the user has an S3 file system that is not mounting, returning access denied, not syncing changes to S3, showing files in lost+found, or performing slower than expected.

Core Features & Use Cases

  • Classify issues by category (mount, permissions, sync, performance) and provide guided remediation steps.
  • Provide safe, auditable diagnostics and recommended fixes for AWS environments.
  • Use Case: A user encounters mount failures and access denied errors in S3 Files; this skill guides through verification, remediation, and validation.

Quick Start

Troubleshoot an S3 Files mount or synchronization issue in your AWS account.

Frequently Asked Questions about troubleshooting-s3-files

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

FAQPage Schema
Why does my S3 file system fail to mount and return access denied errors?

S3 file system mount failures and access denied errors typically stem from missing IAM permissions or dependency issues. This skill guides you through verifying dependencies, classifying the mount or permission problem, and applying structured remediation steps for AWS environments.

How do I fix S3 files not syncing changes to the bucket?

To fix S3 files not syncing, you must classify the synchronization issue and verify IAM policies. This skill diagnoses sync problems, including files appearing in lost+found, and provides safe, auditable remediation steps to ensure changes propagate correctly.

What is causing slow performance in my S3 Files deployment?

Slow performance in S3 Files deployments is classified as a performance category issue. This skill diagnoses the bottleneck and recommends structured fixes to optimize synchronization and read/write speeds while ensuring safe, auditable operations.

How do I troubleshoot S3 Files issues across mount, permission, and sync scenarios?

Troubleshooting S3 Files issues requires classifying the problem by category—mount, permissions, sync, or performance. This skill provides guided verification, structured remediation steps, and clear guardrails to diagnose and resolve issues across these scenarios.

Can I use this S3 Files troubleshooting process for my AWS environment safely?

Yes, this S3 Files troubleshooting process is designed for AWS environments and ensures safe, auditable diagnostics. It applies clear guardrails to every remediation step, verifying dependencies before applying fixes to prevent unsafe operations.