agents-debug

Diagnose AgentCore deployment issues by analyzing traces and logs.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/AndreKurait/claude-marketplace-test --skill agents-debug-andrekurait
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-debug
Source: https://github.com/AndreKurait/claude-marketplace-test/tree/main/plugins/aws-agents/skills/agents-debug
Command: npx skills add https://github.com/AndreKurait/claude-marketplace-test --skill agents-debug-andrekurait

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose why an AgentCore deployment or environment behaves incorrectly by reading traces, logs, and prerequisites, and guide you to root causes. This Skill helps you quickly surface failing tool calls, timeouts, or CLI issues so you can remediate efficiently.

Core Features & Use Cases

  • Analyze traces and logs to pinpoint failures
  • Verify prerequisites and environment
  • Provide step-by-step remediation guidance for CLI, gateway, and tool failures

Quick Start

Describe the current failure by running /agents-debug traces to surface recent traces and identify the root cause.

Frequently Asked Questions about agents-debug

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

FAQPage Schema
How do I diagnose AgentCore deployment issues from traces and logs?

Diagnosing AgentCore deployment issues from traces and logs involves reading recent trace outputs and log files to pinpoint failing tool calls, timeouts, or CLI errors. This analysis identifies the root cause and provides structured remediation guidance to fix the environment.

Why does my agent CLI fail to execute tool calls successfully?

Agent CLI tool call failures often stem from missing prerequisites, environment misconfigurations, or gateway timeouts. Reading the diagnostic traces and logs helps pinpoint the exact failing component and provides step-by-step remediation guidance to resolve the error.

What is the best way to troubleshoot AgentCore timeouts and gateway failures?

The best way to troubleshoot AgentCore timeouts and gateway failures is to surface recent traces and verify the deployment prerequisites. Analyzing these diagnostic logs isolates the root cause and directs you to the specific configuration or network issue requiring remediation.

Can I use safe diagnostic commands to troubleshoot agent errors without causing destructive changes?

Yes, you can use safe diagnostic commands to troubleshoot agent errors without destructive changes. The troubleshooting process relies on reading traces, logs, and references to determine root causes while strictly avoiding any actions that modify or harm the deployment.

Do I need to provide specific log files to start debugging AgentCore issues?

Yes, you need to provide access to traces and log files to start debugging AgentCore issues. The diagnostic process requires these specific inputs to surface failing tool calls, identify the root cause, and guide you through the remediation steps for your deployment.