telemetry

Analyze per-agent execution telemetry from CLAUDE CLI JSONL logs and metadata.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/fjpulidop/specrails-core --skill telemetry-fjpulidop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telemetry
Source: https://github.com/fjpulidop/specrails-core/tree/main/specrails-plugin/skills/telemetry
Command: npx skills add https://github.com/fjpulidop/specrails-core --skill telemetry-fjpulidop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze and unify per-agent telemetry to reveal token usage, costs, throughput, and performance trends across sr-* agents, enabling data-driven optimizations.

Core Features & Use Cases

  • Compute per-agent metrics: run_count, success_rate, average duration, and token usage (input/output/cache).
  • Cost-aware analytics: estimate API costs per agent using Claude pricing by model, with per-model breakdown.
  • Trend-aware dashboards: generate dashboards in Markdown or JSON with recommendations and snapshots for future comparisons.
  • Input sources: reads CLAUDE CLI JSONL session logs and agent-memory metadata to provide a comprehensive view.
  • Use cases: monitor developer workflow efficiency, compare agents, and identify optimization opportunities.

Quick Start

Run /specrails:telemetry to generate a live per-agent telemetry dashboard for the current project.

Frequently Asked Questions about telemetry

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

FAQPage Schema
How do I analyze Claude CLI JSONL logs for token usage and API cost estimation?

The telemetry skill analyzes per-agent execution telemetry from CLAUDE CLI JSONL logs to measure token usage, estimate API costs using Claude pricing, and compute performance trends across all sr-* agents in Markdown or JSON format.

Can I generate a performance dashboard for my agents from JSONL session logs?

Yes, you can generate a performance dashboard from JSONL session logs. The skill computes per-agent metrics like success rate and average duration, rendering trend-aware dashboards in Markdown or JSON with optional persistent snapshots for future comparisons.

What is the best way to compare token usage and throughput across multiple agents?

The best way to compare token usage and throughput across multiple agents is to aggregate per-agent execution telemetry. This skill unifies metrics like run count, token usage, and estimated costs to compare agents and identify optimization opportunities.

Does the telemetry skill require any specific dependencies or environment setup?

The telemetry skill requires no external dependencies, but it needs access to CLAUDE CLI JSONL session logs and agent-memory metadata to parse logs, aggregate metrics, and estimate costs effectively.

Can I filter agent telemetry data by specific time periods or individual agents?

Yes, you can filter agent telemetry data by specific time periods or individual agents. The skill supports optional flags for period and agent selection, allowing you to narrow down the analysis and focus on specific performance trends.

Why are my API cost estimates varying across different Claude agents?

API cost estimates vary across Claude agents because the skill calculates costs using Claude pricing by model. It provides a per-model breakdown, meaning different models used by different agents will result in varied cost estimations for token usage.