agent-debugger-cli

Automate agent trace configuration, QA, and quality analysis via CLI.

1|Updated Jun 5, 2026
One-click install
npx skills add https://github.com/divo12/Harness-Description-Protocol --skill agent-debugger-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-debugger-cli
Source: https://github.com/divo12/Harness-Description-Protocol/tree/main/agents/evolve_agent/skills/agent-debugger-cli
Command: npx skills add https://github.com/divo12/Harness-Description-Protocol --skill agent-debugger-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nexau, langfuse, python-dotenv, requests, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates workflows around the agent debugger CLI, enabling configuration, trace download, QA analysis, and quality checks on agent execution traces.

Core Features & Use Cases

  • Configure LLM Settings: Set up and manage language model configurations for the agent debugger.
  • Download Traces: Retrieve and clean Langfuse traces for analysis.
  • Ask QA Questions: Pose questions about traces and receive answers.
  • Run Quality Check: Perform quality checks on traces to identify issues.
  • Use Case: Suppose you have an agent execution trace and you want to understand the main issues and their causes. Use this Skill to download the trace, ask questions, and run a quality check to get insights.

Quick Start

Run the following command to extract all text from the attached file 'trace.json':

adb ask -t trace.json -q "What are the main issues in this trace?"

Frequently Asked Questions about agent-debugger-cli

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

FAQPage Schema
How do I analyze agent execution traces to find main issues?

You can analyze agent execution traces by running a quality check or posing QA questions directly against the trace file to identify issues and their causes. The CLI automates downloading, cleaning, and evaluating these traces.

How do I download and clean Langfuse traces for debugging?

You can download and clean Langfuse traces for debugging using the agent debugger CLI, which retrieves execution data and prepares it for analysis. Optional network access is required to fetch the traces.

Do I need Python to run quality checks on agent traces?

Yes, you need Python 3.9+ and pip to run quality checks on agent traces using this CLI. Local shell access is also required, and you must configure python-dotenv for environment variables.

What is the best way to configure LLM settings for agent debugging?

The best way to configure LLM settings for agent debugging is through the CLI's configuration commands, which manage language model setups for trace analysis. This ensures the debugger uses the correct model parameters.

Can I ask specific questions about a trace file to debug my agent?

Yes, you can ask specific questions about a trace file to debug your agent by using the ask command with the trace and query parameters. This returns targeted answers regarding issues within the execution data.

Why does trace analysis fail when running locally without network access?

Trace analysis fails without network access if the CLI needs to download Langfuse traces or make model calls. While local trace files can be analyzed offline, retrieving remote data requires an active connection.