trace

Trace agent flow events and summarize mode transitions and bottlenecks.

1|Updated Sep 22, 2025
One-click install
npx skills add https://github.com/prthik/prathik-astro --skill trace-prthik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/prthik/prathik-astro/tree/main/.codex/skills/trace
Command: npx skills add https://github.com/prthik/prathik-astro --skill trace-prthik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a clear, unified view of an agent's runtime flow by presenting an event timeline and a concise summary, helping teams understand how hooks, keywords, skills, agents, and tools interact during a session.

Core Features & Use Cases

  • Timeline: Visualize the chronological sequence of hooks, keywords, skills, agents, and tools during a session.
  • Summary: Aggregate statistics such as hook fires, detected keywords, activated skills, mode transitions, and tool performance.
  • Use Case: Debug complex agent orchestrations in multi-step conversations by identifying where delays or misrouting occur.

Quick Start

Show me the latest session's trace 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 an agent flow timeline to debug multi-step orchestration?

To trace an agent flow timeline, this Skill visualizes the chronological sequence of hooks, keywords, skills, agents, and tools during a session. It applies to the latest session to help debug complex orchestrations by identifying delays or misrouting.

What is the best way to visualize mode transitions and tool performance in an agent session?

Visualizing mode transitions and tool performance requires aggregating runtime statistics into a summary. This Skill provides a structured output that highlights flow patterns, hook fires, and activated skills for the latest session.

Can I filter agent flow tracing results by specific event types?

Yes, you can filter agent flow tracing results by specific event types. The Skill applies optional filters to the latest session timeline, allowing you to limit results and focus on particular hooks, keywords, or tools.

How does agent flow tracing identify bottlenecks in multi-step conversations?

Agent flow tracing identifies bottlenecks by presenting a detailed event timeline and concise summary of runtime interactions. It maps how hooks, skills, agents, and tools interact to pinpoint where delays or misrouting occur during a session.

Do I need any dependencies to generate an agent flow timeline and summary?

No dependencies are required to generate an agent flow timeline and summary. The Skill operates independently to trace the latest session and produce structured outputs highlighting mode transitions and flow patterns.