ptp-telemetry-analyze

Analyzes recorded ptp telemetry spans to report model, tool, and subagent time distribution.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-telemetry-analyze-almogmaayan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ptp-telemetry-analyze
Source: https://github.com/AlmogMaayan/ptp/tree/main/skills/ptp-telemetry-analyze
Command: npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-telemetry-analyze-almogmaayan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Answering where time actually went during Claude Code sessions — inside subagents versus the main agent, by model, by tool, by bash command — normally requires re-reading and re-aggregating raw telemetry on every question, which is slow, token-expensive, and non-reproducible. This skill provides a predefined, deterministic analysis engine over the recorded ptp telemetry store. ## Core Features & Use Cases - Predefined analysis engine: Runs scripts/ptp-telemetry-analyze.js (Node standard library only, no install step) over the raw NDJSON span store, with a CSV fallback when no raw files exist. - Subagent vs main-agent split: Classifies leaf spans by parent links or per-session timestamp containment against wrapper windows, naming the method used in a mandatory data-quality footer. - Honest degradation: Reports unavailable rather than 0 for figures the CSV fallback cannot measure, and states exactly when retention has narrowed the analyzed scope. - Use Case: After several weeks of ptp pipeline runs, ask which models and bash commands consumed the most time and how much work happened inside subagents, and receive a reproducible report with per-key counts and a data-quality footer. ## Quick Start Ask the assistant to run the ptp telemetry analyze report for this repository to show where time went by model, tool, and subagent.

Frequently Asked Questions about ptp-telemetry-analyze

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

FAQPage Schema
How do I analyze Claude Code telemetry to see where time went?▼

Run the ptp telemetry analyze command, which executes a predefined Node script over the recorded span store. It reports time split by model, tool, bash command, and inside-subagent versus main-agent work, with a data-quality footer.

How does the analysis distinguish subagent work from main-agent work?▼

It classifies each leaf span by parent links when a resolvable trace chain exists, otherwise by timestamp containment against the per-session union of wrapper windows. The method used is named in the footer on every run.

Does ptp telemetry analyze require any npm dependencies?▼

No. The analysis script uses only the Node.js standard library (fs and path) plus a sibling workspace-resolution script, so there is no package.json or install step.

What happens when raw telemetry files have been pruned by retention?▼

The analysis falls back to spans.csv only if no raw file exists anywhere, and the footer states when scope is narrowed to the raw-retained window. Figures the CSV cannot support, like bash command grouping, are omitted with the reason printed.

Why does the report show unavailable instead of zero for some counts?▼

A count that was measured and came out zero prints 0, but a count that could not be taken — such as subagent_completed rows under the CSV fallback — prints unavailable. Printing 0 would assert something the data cannot establish.