trace

Display chronological flow traces of hooks, keywords, skills, agents, and tools.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/wmasfoe/notch-pet --skill trace-wmasfoe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/wmasfoe/notch-pet/tree/main/.codex/skills/trace
Command: npx skills add https://github.com/wmasfoe/notch-pet --skill trace-wmasfoe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Display comprehensive flow traces of hooks, keywords, skills, agents, and tools to understand session interactions.

Core Features & Use Cases

  • Timelines: view chronological event sequences for debugging and performance analysis.
  • Summary: aggregate statistics on hooks, keywords, skills activated, mode transitions, and tool performance.
  • Use Cases: debugging complex agent workflows, auditing session behavior, and diagnosing bottlenecks across sessions.

Quick Start

Display the latest session's trace timeline and summary using the trace_timeline and trace_summary tools.

Frequently Asked Questions about trace

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

FAQPage Schema
How do I debug complex agent workflows and diagnose session bottlenecks?

You can trace agent workflows by displaying comprehensive flow traces of hooks, keywords, skills, agents, and tools. This generates a chronological timeline and aggregate statistics to diagnose session bottlenecks and audit session behavior.

What is the best way to view chronological event sequences for agent performance analysis?

The best way to view chronological event sequences for agent performance analysis is using the trace_timeline tool. It displays chronological event sequences across sessions, allowing you to filter by event types to focus on specific interactions during debugging.

Can I get aggregate statistics on hooks, keywords, and tool performance across sessions?

Yes, you can get aggregate statistics on hooks, keywords, skills activated, mode transitions, and tool performance across sessions. The trace_summary tool provides these aggregate statistics to help audit session behavior and analyze agent workflows.

How do I filter event types when tracing agent sessions?

You can filter event types when tracing agent sessions by using the trace_timeline tool. It provides filters to focus on specific event types like hooks, keywords, skills, agents, and tools, enabling targeted debugging and analysis of session interactions.

Does this tracing tool require any dependencies to analyze agent flows?

No, this tracing tool requires no dependencies to analyze agent flows. It provides the trace_timeline and trace_summary tools directly to display comprehensive flow traces and aggregate statistics for understanding session interactions.