Use when your agent or environment is broken — wrong answers, errors, timeouts, tool failures, or CLI issues. Reads traces and logs to diagnose root causes. Also checks prerequisites when the CLI itself isn't working.
Install
npx skills add aws/agent-toolkit-for-aws --skill agents-debugnpx skills add aws/agent-toolkit-for-aws --skill agents-debug -a claude-code -gnpx skills add aws/agent-toolkit-for-aws --skill agents-debug -a codex -ggemini skills install https://github.com/aws/agent-toolkit-for-aws.git --path plugins/aws-agents/skills/agents-debuggh skill install aws/agent-toolkit-for-aws agents-debuggit clone --depth 1 https://github.com/aws/agent-toolkit-for-aws /tmp/aws__agent-toolkit-for-aws
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/aws__agent-toolkit-for-aws/plugins/aws-agents/skills/agents-debug ~/.claude/skills/agents-debug # Claude Code
cp -R /tmp/aws__agent-toolkit-for-aws/plugins/aws-agents/skills/agents-debug ~/.agents/skills/agents-debug # Codex, Cursor, Gemini CLI, Copilot, OpenCode