# Report

> Generate a short markdown analytics report answering a specific product question. Pass the question as arguments.

- **Type:** Skill
- **Install:** `agentstack add skill-agenkin-telemetrydeck-analytics-report`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [agenkin](https://agentstack.voostack.com/s/agenkin)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [agenkin](https://github.com/agenkin)
- **Source:** https://github.com/agenkin/telemetrydeck-analytics/tree/main/skills/report
- **Website:** https://github.com/agenkin/telemetrydeck-analytics

## Install

```sh
agentstack add skill-agenkin-telemetrydeck-analytics-report
```

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

## About

# Report

Write a compact markdown analytics report that answers the user's question in `$ARGUMENTS`. This skill is the high-level wrapper: pick the right sub-query (recipe or raw TQL), run it, and turn the numbers into a narrative.

## Process

1. **Parse the question** in `$ARGUMENTS`. Identify: metric (count vs. users), dimension (if any), window, comparison target.
2. **Pick the command**:
   - DAU/MAU trend → `tdq dau` / `tdq mau`
   - Breakdown by one dimension → `tdq groupby `
   - Which events fire → `tdq events`
   - Funnel / retention / multi-dim groupby / derived metric → write raw TQL and run via `tdq query -` (consult `skills/analytics/tql/index.md` for syntax).
3. **Run it** — use the Bash tool. Capture the table output.
4. **Write the report** using this structure:

```markdown
## 

**Top-line:** 

**Method:** ``

**Result:**

**Interpretation:** 

**Caveats:** Opt-in cohort only (TelemetryDeck samples self-selected users). 
```

5. **Where to save**: inline in the conversation by default. If the user asks for a file, ask them where to save it; write to the absolute path they give. Suggest `~/Documents/TelemetryDeck/YYYY-MM-DD-.md`. **Never create new top-level folders in the current working directory.**

## Defaults

- Window: last 30 days unless the question implies otherwise.
- Format: `table` (markdown-ready).
- Always include the opt-in-cohort caveat.
- For "trending" / "growing" / "vs. last period" phrasings, add `--compare prior-period`.

## Source & license

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

- **Author:** [agenkin](https://github.com/agenkin)
- **Source:** [agenkin/telemetrydeck-analytics](https://github.com/agenkin/telemetrydeck-analytics)
- **License:** MIT
- **Homepage:** https://github.com/agenkin/telemetrydeck-analytics

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-agenkin-telemetrydeck-analytics-report
- Seller: https://agentstack.voostack.com/s/agenkin
- 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%.