ptp-telemetry-report

Summarizes recorded telemetry into reports of runs, models, and durations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Raw telemetry stores (spans.csv, runs.ndjson) are hard to interpret directly. This Skill turns recorded PtP telemetry into a readable report answering "where is time wasted?" — computing headline work-time and wall-time figures, concurrency factors, breakdowns, and top time sinks per epic or story. ## Core Features & Use Cases - Headline figures: Computes aggregate work time, elapsed wall time, and a concurrency factor per reporting scope, never summing across epics. - Breakdowns and top-N lists: Groups time by phase, agent role, span kind, and tool class, and lists the slowest spans, slowest tool classes, and costliest repeated tool calls (N = 10). - Selector-scoped reporting: Accepts epic:all, epic:XXXX, story:NN, or bare change ids via the shared change-selector grammar, with an empty argument defaulting to all active epics. - Bounded retention pruning: Deletes aged raw telemetry files according to the configured retention window while leaving derived stores untouched. - Use Case: After several pipeline runs, ask for a telemetry report on epic 0032 to see which phase and tool class consumed the most time and which repeated Bash calls were costliest. ## Quick Start Ask the AI to run a telemetry report for a specific epic, for example: generate a telemetry report for epic:0032 showing where time was spent.

Frequently Asked Questions about ptp-telemetry-report

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

FAQPage Schema
How do I generate a telemetry report for a specific epic?▼

Pass an epic selector such as epic:0032 to the report command. An empty argument defaults to epic:all, reporting each active epic separately, and story-level selectors like epic:0032 story:01 narrow the report to rows matching that change id.

What inputs does the telemetry report read?▼

The report reads only the derived store files spans.csv and runs.ndjson, never the raw/ directory. This keeps report output stable between pruning and the next export, since raw and derived stores intentionally hold different histories.

Does running a telemetry report modify or delete any data?▼

A default report creates no file and modifies nothing, but it does delete aged raw telemetry files per the configured retention window. Writing a report.md file happens only when the explicit write keyword is passed.

Why is the concurrency factor sometimes undefined or below 1?▼

The factor is reported undefined when elapsed wall time or aggregate work time is missing, such as ledger-only scopes. Values below 1 are legitimate when spans were dropped or the sink was down mid-run, and are reported as-is with a footer explanation.

What is the difference between the report and analyze telemetry commands?▼

Report reads derived files (spans.csv, runs.ndjson) and produces per-epic figures, while analyze reads the raw store as a separate reader with its own input rule. They share no printed figure, so their outputs never disagree about the same past.