Individual skill
agents-debug
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. Triggers on: "agent not working", "wrong answer", "agent error", "tool call failing", "debug agent", "check logs", "read traces", "broken", "500 error", "424 error", "model access denied", "command not found", "stuck in DELETING", "maxVms exceeded", "cold start diagnosis", "cold start slow", "agentcore create error", "create failed", "exit code 7", "connection refused local dev". Not for deploy failures — use agents-deploy. Not for performance tuning without errors — use agents-optimize. Not for VPC configuration — use agents-build. Not for observability setup or missing logs — use agents-optimize.
plugins/aws-agents/skills/agents-debug/SKILL.md
Source commit fe004f4aa06867e5a9bb66f9d8dce7723924fc50
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 10, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 3,449
- Repository last updated
- Nov 10, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesSKILL.mdcore · 31,061 bytesreferences/doctor.mddoc · 5,997 bytes
Read excerpt
# debug
Diagnose why your AgentCore agent or environment isn't working correctly.
## When to use
- Your agent is returning wrong answers or errors
- Tool calls are failing or timing out
- Agent works locally but fails after deploying
- Logs aren't showing up in CloudWatch
- The AgentCore CLI isn't working or environment seems broken
- `agentcore` command not found or prerequisites are missing
Do NOT use for: