Agent skill · software engineering · lobehub
agent-tracing
Use for agent traces by operation ID (拉线上 tracing): failed tools, arguments/results, available tools, execution location, LLM calls and context.
Why this skill is useful
Adds a CLI tool for tracing agent execution with detailed snapshot capabilities that aren't covered in public documentation.
What it needs
Requires node installed locally. About 11k tokens when loaded. Last updated 2026-08-07. 81,352 stars on the source repository.
What this skill does
Agent Tracing CLI Guide @lobechat/agent-tracing is a zero-config local dev tool that records agent execution snapshots to disk and provides a CLI to inspect them. How It Works In NODEENV=development, AgentRuntimeService.executeStep() automatically records each step to .agent-tracing/ as partial snapshots. When the operation completes, the partial is finalized into a complete ExecutionSnapshot JSON file. Data flow: executeStep loop -> build StepPresentationData -> write partial snapshot to disk -> on completion, finalize to .agent-tracing/{timestamp}{traceId}.json Context engine capture: In RuntimeExecutors.ts, the callllm executor calls ctx.tracingContextEngine(input, output, metadata) after serverMessagesEngine() processes messages. AgentRuntimeService.executeStep buffers the call per step and forwards it to OperationTraceRecorder.appendStep as the typed contextEngine field. CE flows through this side channel rather than the events array so its heavy payload (agentDocuments, systemRole, …) never enters the Redis state pipeline (LOBE-9110). metadata carries the pipeline's per-request decision records (trim stats, cache-warmth gates, truncation counts). Package Location Data Storage Completed snapshots: .agent-tracing/{ISO-timestamp}{traceId-short}.json Latest symlink: .agent-tracing/latest.json In-progress partials: .agent-tracing/partial/{operationId}.json Downloaded remote snapshots: .agent-tracing/remote/{operationId}.json FileSnapshotStore resolves from process.cwd() — run CLI from the repo root Remote Traces (Production / Staging) Server deployments also upload completed snapshots to object storage (zstd-compressed; the key is stored in agentoperations.traces3key). Preferred: lh trace op. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills lobehub/agent-tracing--aa6241