trace

Trace data flow and bugs across BrassClaw message, SSE, and tool flows.

Updated May 7, 2026
One-click install
npx skills add https://github.com/chtugha/brassclaw --skill trace-chtugha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/chtugha/brassclaw/tree/main/.bob/skills/trace
Command: npx skills add https://github.com/chtugha/brassclaw --skill trace-chtugha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive tracing mechanism to help diagnose and understand the flow of data and the execution path of functions within the BrassClaw codebase.

Core Features & Use Cases

  • End-to-End Tracing: Trace the flow of data or bugs through the entire BrassClaw system, including message flow, SSE event flow, and tool flow.
  • Message Flow Analysis: Analyze the user input to LLM response message flow, identifying every file and function involved.
  • Data Transform Identification: Map data transformations and potential failure points within the system.
  • Quick Reference to Key Files: Access a quick reference to key files and functions for efficient debugging.

Quick Start

Run the 'trace' skill with the symptom or feature name you want to investigate, e.g., 'trace "calendar update error"'

Frequently Asked Questions about trace

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

FAQPage Schema
How do I trace data flow and diagnose bugs in the BrassClaw codebase?

To trace data flow and diagnose bugs in the BrassClaw codebase, you can run a dedicated tracing skill with a specific symptom or feature name. This identifies involved files, data transformations, and failure points across the system.

What is the best way to debug message flow from user input to LLM response?

Debugging message flow from user input to LLM response involves analyzing the end-to-end execution path to identify every file and function handling the data. This process maps out data transformations and highlights potential failure points.

Can I analyze SSE event flow and tool flow for debugging BrassClaw applications?

Yes, you can analyze SSE event flow and tool flow for debugging BrassClaw applications. The tracing mechanism covers these specific execution paths, helping you understand how events and tools process data throughout the system.

How do I identify failure points and key files when investigating a specific BrassClaw issue?

To identify failure points and key files when investigating a BrassClaw issue, execute a trace using the symptom name. This provides a quick reference to the exact functions and files involved in the data transformation.