wf-trajectory

Render workflow telemetry JSON into a self-contained offline HTML visualization.

8|Updated Jun 18, 2026
One-click install
npx skills add https://github.com/ddobrin/plan-skills --skill wf-trajectory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wf-trajectory
Source: https://github.com/ddobrin/plan-skills/tree/main/plugins/plan/skills/wf-trajectory
Command: npx skills add https://github.com/ddobrin/plan-skills --skill wf-trajectory

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns workflow telemetry JSON into an offline visual report, making it easier to understand execution status, phase structure, agent activity, parallelism, and workflow results without manually inspecting raw records.

Core Features & Use Cases

  • Run Discovery: Locates the newest or a specified workflow run from the Claude configuration directory, including project-aware and global run lookup.
  • Execution Modeling: Parses workflow phases, agent states, timing data, token usage, tool calls, previews, results, and transcript locations.
  • Offline Visualization: Generates a self-contained HTML dashboard with summary metrics, a collapsible run-to-phase-to-agent tree, transcript links, result output, and a parallelism timeline.
  • Validation and Resilience: Handles missing fields defensively, reports malformed or unavailable runs clearly, escapes rendered content, and includes automated tests for parsing, rendering, locating, and timeline calculations.
  • Use Case: When a workflow has completed, use this Skill to inspect which agents ran in parallel, review their prompts and results, and trace the overall execution from a single browsable report.

Quick Start

Use the wf-trajectory skill from the project directory to render the newest workflow run, or provide a specific workflow run identifier to inspect that execution.

Frequently Asked Questions about wf-trajectory

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

FAQPage Schema
How do I visualize Claude Code workflow execution telemetry offline?

You can visualize Claude Code workflow execution telemetry offline by rendering the workflow run JSON data into a self-contained HTML dashboard using Python, allowing you to inspect execution status, agent activity, and parallelism without an internet connection.

What is a workflow trajectory report and when do I need one?

A workflow trajectory report is an offline HTML visualization of completed workflow telemetry. You need one when you want to review execution phases, inspect agent prompts, analyze token usage, and trace parallel agent execution from a single browsable interface.

How do I inspect which agents ran in parallel during a workflow run?

To inspect which agents ran in parallel during a workflow run, you generate an offline HTML visualization that includes a parallelism Gantt timeline, modeling parsed phase structures, agent states, and timing data from the workflow telemetry.

Does workflow visualization require Python and local transcript files?

Yes, workflow visualization requires Python and the local workflow run JSON data along with its associated local assets and transcript files to accurately parse execution states and render the offline HTML report.

Can I render a specific workflow run instead of the newest one?

Yes, you can render a specific workflow run by providing a specific workflow run identifier, otherwise the skill automatically locates and renders the newest run discovered from the Claude configuration directory.

What happens if the workflow run JSON is malformed or missing fields?

If the workflow run JSON is malformed or missing fields, the visualization handles missing data defensively and clearly reports malformed or unavailable runs rather than failing to execute the HTML rendering process.