telegram-group-analytics-bot — Claude Code skill: Telegram group stats
This skill tracks Telegram group activity: member growth, message counts, hourly heatmaps and scheduled reports you can export.
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a claude-codeWhat telegram-group-analytics-bot does
The skill gives your agent a set of tools for reading Telegram group activity. It counts joins and leaves, messages per user, and builds hourly and daily heatmaps. Reports go out as CSV, HTML or PDF, and the schedule lives in config.json — a daily report at 09:00, for instance.
Under the hood is the telegram_analytics Python library with GroupAnalyzer, MessageTracker, ReportGenerator, AlertManager and DataExporter. Everything lands in a stats.db database. The bot also answers commands in the chat itself: /stats, /growth, /activity, /export csv. Alerts fire when message counts or active users drop below thresholds you set.
You need a bot token from @BotFather and the group ID, passed through TELEGRAM_BOT_TOKEN and TELEGRAM_GROUP_ID. Without those, nothing runs. Python and the packages in requirements.txt are required too.
What it helps with
- measure member growth and churn over a week
- find the most active posters in a month
- build an hourly activity heatmap
- export group stats to CSV or PDF
- set up a daily report with an activity threshold
Example prompts for the agent
- analyze Telegram group stats for the last 7 days
- generate a weekly activity report and save it as PDF
- show the top 10 users by message count
How to install telegram-group-analytics-bot
1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a claude-code2Manually: put the files in place
~/.claude/skills/telegram-group-analytics-bot/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/telegram-group-analytics-bot/
1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a codex2Manually: put the files in place
.agents/skills/telegram-group-analytics-bot/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a cursor2Manually: put the files in place
.cursor/skills/telegram-group-analytics-bot/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/data-skills telegram-group-analytics-bot2Manually: put the files in place
.github/skills/telegram-group-analytics-bot/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/data-skills --path skills/telegram-group-analytics-botManually: put the files in place
.devin/skills/telegram-group-analytics-bot/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about telegram-group-analytics-bot
How do I install telegram-group-analytics-bot in Claude?
Run npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a claude-code. The skill file then lands in ~/.claude/skills/telegram-group-analytics-bot/SKILL.md.
What does telegram-group-analytics-bot do?
It counts member growth, messages and hourly activity, then generates reports in CSV, HTML or PDF. It can also send alerts when activity falls below a threshold.
What do I need to run it?
A bot token from @BotFather and the group ID, set as TELEGRAM_BOT_TOKEN and TELEGRAM_GROUP_ID. You also need Python and the dependencies from requirements.txt.