trace

Generate a chronological agent flow trace timeline and summary.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/shaun0927/codex-superskills --skill trace-shaun0927
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/shaun0927/codex-superskills/tree/main/skills/trace
Command: npx skills add https://github.com/shaun0927/codex-superskills --skill trace-shaun0927

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly identify and understand how hooks, keywords, skills, agents, and tools interact by producing a clear, time-ordered trace.

Core Features & Use Cases

  • Timeline visualization: Show chronological events across hooks, keywords, skills, agents, and tools.
  • Summary statistics: Provide aggregate metrics such as hook fires, keywords detected, mode transitions, and bottlenecks.
  • Use Case: When debugging complex interactions, run trace mode to identify flow patterns and performance issues.

Quick Start

Run trace on the latest session to display a comprehensive flow timeline and summary.

Frequently Asked Questions about trace

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

FAQPage Schema
How do I trace and debug agent workflow execution step by step?

To debug agent interactions, run trace mode to produce a chronological timeline and structured summary. This end-to-end view shows how hooks, keywords, skills, agents, and tools execute sequentially to identify flow patterns.

How do I visualize a timeline of agent mode transitions and tool interactions?

Visualize agent mode transitions by generating a chronological timeline that maps events across hooks, keywords, skills, agents, and tools. This single view allows you to monitor execution flow and pinpoint exactly where transitions occur.

What is the best way to identify performance bottlenecks in complex agent interactions?

The best way to identify performance bottlenecks is to apply trace mode during complex interactions. It produces summary statistics with aggregate metrics, highlighting hook fires, detected keywords, and specific mode transitions causing delays.

Can I filter the agent flow trace timeline by specific event types?

Yes, you can filter the agent flow trace timeline using configurable event-type filters. This allows you to isolate specific hooks, keywords, skills, agents, or tools within the chronological execution view for targeted telemetry analysis.

Does the agent flow trace tool require any external dependencies to run?

No, the agent flow trace tool requires no external dependencies to run. It operates directly on your latest session to produce the chronological timeline, structured summary, and bottleneck analysis without needing additional setup.