telemetry

Log opt-in local-first skill usage telemetry with JSONL and version checks.

15|3|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/LazyIsEfficient/agentic-os --skill telemetry-lazyisefficient
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telemetry
Source: https://github.com/LazyIsEfficient/agentic-os/tree/main/.claude/skills/telemetry
Command: npx skills add https://github.com/LazyIsEfficient/agentic-os --skill telemetry-lazyisefficient

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Telemetry provides opt-in, local-first usage data for the skills library, enabling visibility into which skills run and how reliably, without exposing code or content.

Core Features & Use Cases

  • Local usage logging: records anonymized per-skill runs on the user's machine.
  • Opt-in telemetry: gives users control over sending aggregate data to an analytics endpoint.
  • Version checks: informs users when newer library releases are available.

Quick Start

Configure opt-in telemetry to start logging runs locally and optionally send anonymized data for improvement.

Frequently Asked Questions about telemetry

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

FAQPage Schema
How do I collect local-first usage telemetry for scripts without exposing code?

Local-first telemetry collects opt-in usage data on your machine using local JSONL logging. It records anonymized per-skill runs, tracking duration and success without exposing your underlying code or content.

What is opt-in telemetry and how does it preserve privacy?

Opt-in telemetry requires explicit user configuration before collecting or sending data. It preserves privacy by storing anonymized usage logs locally first, using a persistent opt-in mechanism to control whether aggregate data is sent to a remote analytics endpoint.

How do I log per-skill runs and track duration locally?

You log per-skill runs locally by enabling the telemetry configuration. The system automatically records execution duration and success status into a local JSONL log file on your machine for later observation.

Can I send anonymized usage analytics to a remote endpoint?

Yes, you can send anonymized usage analytics to a remote stub endpoint. This optional remote analytics feature is disabled by default and requires configuring the persistent opt-in mechanism to transmit aggregate data.

How do I check for newer library releases and surface version updates?

You check for newer library releases using the cache-backed version-check workflow. This telemetry feature queries for available release updates and surfaces them to the user while maintaining local-first privacy constraints.

Are there limitations to using local JSONL logging for skill analytics?

Local JSONL logging limitations include requiring manual configuration for opt-in data collection and remote analytics. The remote endpoint is currently a stub, meaning actual external data transmission functionality may be limited or require further implementation.