# telegram-group-statistics-analytics-bot

Tracks Telegram group member changes, counts messages by participant, and exports periodic activity summaries. Designed for community managers monitoring chat health.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 605 installs · ★ 5
- Author: reason-machines
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/data-skills/tree/HEAD/skills/telegram-group-statistics-analytics-bot/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/telegram-group-statistics-analytics-bot

## What it does

This skill provisions an analytics bot tailored for Telegram group chats. It logs incoming messages, tracks member joins or departures, and calculates hourly activity heatmaps. The system also supports data exports in CSV or JSON.

The engine runs on Python using `python-telegram-bot` alongside SQLAlchemy with SQLite or PostgreSQL storage. Periodic document generation relies on `reportlab` and `matplotlib` to export PDF or HTML digests. Configuration details and target chat IDs sit inside `config.json`.

Without `TELEGRAM_BOT_TOKEN` and API credentials from my.telegram.org, the bot cannot connect to the chat stream. Administrator rights inside the target group are required to capture member events.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-statistics-analytics-bot -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/telegram-group-statistics-analytics-bot/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/telegram-group-statistics-analytics-bot/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-statistics-analytics-bot -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/telegram-group-statistics-analytics-bot/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-statistics-analytics-bot -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/telegram-group-statistics-analytics-bot/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/data-skills telegram-group-statistics-analytics-bot
```

2. **Manually: put the files in place**
- File: `.github/skills/telegram-group-statistics-analytics-bot/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-statistics-analytics-bot -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/data-skills --path skills/telegram-group-statistics-analytics-bot
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/telegram-group-statistics-analytics-bot/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-statistics-analytics-bot -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/data-skills/tree/HEAD/skills/telegram-group-statistics-analytics-bot/SKILL.md

## When to use it
- track member join and departure trends over time
- generate hourly and daily group activity heatmaps
- compile periodic PDF and HTML community reports
- alert administrators when group message frequency drops sharply

## Example prompts
- Analyze Telegram group message stats for the past 7 days and show top posters
- Generate an activity heatmap for the chat across weekdays and hours
- Configure automated weekly PDF reporting for Telegram group analytics

## Similar
- [access](https://affpapa.org/en/nevibecode/skills/access-2.md) — skill · 3867 installs
- [configure](https://affpapa.org/en/nevibecode/skills/configure-2.md) — skill · 3861 installs
- [claude-to-im](https://affpapa.org/en/nevibecode/skills/claude-to-im.md) — skill · 7100 installs
- [mode-creator](https://affpapa.org/en/nevibecode/skills/mode-creator.md) — skill · 1300 installs
- [telegram-bot-builder](https://affpapa.org/en/nevibecode/skills/sickn33-telegram-bot-builder.md) — skill · 3700 installs
- [chat-sdk](https://affpapa.org/en/nevibecode/skills/vercel-chat-sdk.md) — skill · 5400 installs

From the same set: [reason-machines/data-skills](https://affpapa.org/en/nevibecode/by/reason-machines/data-skills.md) — 74 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md