ClaudeSuperPower

agents-debug

Skill

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 failin

Install

git clone https://github.com/aws/agent-toolkit-for-aws.git ~/.claude/skills/agents-debug

What is 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.

What this can do

Capabilities declared in this component's own frontmatter — not inferred.

~206 tokens of context used while enabled, before you invoke anything

All declared tools (1)
Read Grep Glob Bash

Documentation

README · ~19 min read

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:

Reviews

Log in to leave a review.

No reviews yet — be the first.

Explore related

Other things in this space — across every part of the ecosystem, not just skills.

Skillssimilar to this one

All skills