Troubleshooting Efs

This handles the usual EFS headaches: mount timeouts, permission errors, slow throughput, and burst credit exhaustion. It walks you through the diagnostic tree, from verifying NFS client tools are installed to checking security groups (the number one culprit for timeouts), IAM policies, and performance modes. The skill knows to test connectivity with netcat, read CloudWatch metrics for burst credits, and switch you to Elastic throughput when needed. It also covers the less obvious stuff like VPC DNS settings and KMS key issues on encrypted file systems. Helpful if you've ever watched a mount command hang for two minutes before timing out, or gotten "access denied by server" and weren't sure if it was IAM or POSIX permissions.

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

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

Troubleshooting EFS

Overview

Domain expertise for diagnosing and resolving Amazon EFS issues. Covers mount failures, NFS connectivity, IAM and POSIX permissions, throughput and performance, and encryption problems.

For authoritative guidance, see EFS Troubleshooting.

Common Tasks

0. Verify Dependencies

You MUST verify aws CLI is available
You MUST check if amazon-efs-utils or nfs-utils is installed on the instance
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 what each step does and why before executing it
You SHOULD display write commands and wait for user confirmation before executing