# Skill Telemetry

> Client-side telemetry reporter for Skill invocations. Sends usage events to telemetry-server when any Skill is activated. Keywords: telemetry, usage report, skill tracking

- **Type:** Skill
- **Install:** `agentstack add skill-taosdata-agent-skills-skill-telemetry`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [taosdata](https://agentstack.voostack.com/s/taosdata)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [taosdata](https://github.com/taosdata)
- **Source:** https://github.com/taosdata/agent-skills/tree/main/skills/skill-telemetry

## Install

```sh
agentstack add skill-taosdata-agent-skills-skill-telemetry
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# skill-telemetry

Client-side telemetry reporter. When any Skill is activated, this Skill sends a single invocation event to `skill-telemetry-server` for usage analytics.

> **Privacy**: Only Skill metadata (name, version, author) and machine identifiers (OS, IP) are reported.
> No user input, file content, or secrets are collected. All data stays on the internal network.

## When to Use

Triggered automatically by the `## Telemetry (MUST)` section in every Skill. No user interaction required.

## Input

| Param | Required | Source | Description |
|-------|:--------:|--------|-------------|
| `name` | ✅ | Caller's frontmatter `name` | Skill identifier |
| `version` | ✅ | Caller's `metadata.version` | Skill version |
| `author` | ✅ | Caller's `metadata.author` | Skill author |

## Agent Execution Rule

**Agent MUST run the telemetry command below BEFORE executing the caller Skill's logic.**
Mandatory — must not be skipped. Failure is non-blocking but the attempt is required.

Replace `{{SKILL_NAME}}`, `{{SKILL_VERSION}}`, `{{SKILL_AUTHOR}}` with actual values from the caller Skill's frontmatter.

> The agent MUST resolve the path to `scripts/telemetry.py` (or `scripts/telemetry.ps1` on Windows)
> relative to this SKILL.md file. If the path cannot be resolved, set `SKILL_TELEMETRY_SCRIPT`
> to the absolute path. If both fail, skip telemetry silently.

**Linux / macOS:**

```bash
python3 "${SKILL_TELEMETRY_SCRIPT:-}" "{{SKILL_NAME}}" "{{SKILL_VERSION}}" "{{SKILL_AUTHOR}}" 2>/dev/null &
```

**Windows:**

```powershell
& "${env:SKILL_TELEMETRY_SCRIPT:-}" '{{SKILL_NAME}}' '{{SKILL_VERSION}}' '{{SKILL_AUTHOR}}'
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [taosdata](https://github.com/taosdata)
- **Source:** [taosdata/agent-skills](https://github.com/taosdata/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-taosdata-agent-skills-skill-telemetry
- Seller: https://agentstack.voostack.com/s/taosdata
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.