Provides a chronological timeline and statistical summary of agent events, skills, and tool usage.

Install

mkdir -p .claude/skills/trace-yangyuan-zhen && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/17507" && unzip -o skill.zip -d .claude/skills/trace-yangyuan-zhen && rm skill.zip

Installs to .claude/skills/trace-yangyuan-zhen

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

[OMX] Show agent flow trace timeline and summary
48 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Display a chronological event timeline of agent interactions
  • Filter timeline events by type (hooks, skills, agents, keywords, tools, modes)
  • Show aggregate statistics for hook fire counts and keywords detected
  • Identify mode transitions in agent execution
  • Highlight slow tools or agents as bottlenecks
  • Analyze flow patterns like keyword-skill-agent chains

How it works

This skill uses the `trace_timeline` and `trace_summary` MCP tools to analyze session logs. It presents a chronological event timeline and aggregate statistics of agent interactions.

Inputs & outputs

You give it
trace_timeline()
You get back
A chronological event timeline of the latest session

When to use trace

  • Debug agent flow patterns
  • Identify tool bottlenecks
  • Verify skill activations
  • Analyze session event timeline

About this skill

Agent Flow Trace

[TRACE MODE ACTIVATED]

Objective

Display the flow trace showing how hooks, keywords, skills, agents, and tools interacted during this session.

Instructions

  1. Use trace_timeline MCP tool to show the chronological event timeline

    • Call with no arguments to show the latest session
    • Use filter parameter to focus on specific event types (hooks, skills, agents, keywords, tools, modes)
    • Use last parameter to limit output
  2. Use trace_summary MCP tool to show aggregate statistics

    • Hook fire counts
    • Keywords detected
    • Skills activated
    • Mode transitions
    • Tool performance and bottlenecks

Output Format

Present the timeline first, then the summary. Highlight:

  • Mode transitions (how execution modes changed)
  • Bottlenecks (slow tools or agents)
  • Flow patterns (keyword -> skill -> agent chains)

When not to use it

  • When detailed code-level debugging is required instead of agent flow analysis

Limitations

  • Analysis is based on session logs
  • Focuses on agent flow and performance, not detailed code execution

How it compares

This skill provides a structured overview of agent execution flow and performance bottlenecks, which is more efficient than manually sifting through raw session logs.

Compared to similar skills

trace side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
trace (this skill)03moNo flagsIntermediate
langsmith-observability46moReviewIntermediate
error-diagnostics-smart-debug53moNo flagsAdvanced
debugging-toolkit-smart-debug43moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry