telegram-read_skill

Overview

This skill reads and searches locally synced Telegram messages so you can inspect conversation history, filter by date or topic, and export results. It returns human-friendly Markdown by default and can output structured JSON for downstream processing. Use it to quickly find messages, review recent activity, or produce a message dump for analysis.

How this skill works

The skill reads message data from a local sync of Telegram groups and topics. You can request the latest N messages, search by keyword, filter by date, or target a specific group/topic. Results are formatted as readable Markdown or as JSON when the JSON output flag is used.

When to use it

• You want to view recent activity in a Telegram group or topic
• You need to find messages that contain a specific keyword or phrase
• You want to export message data for analysis or reporting
• You need to review messages from a particular date
• You want a quick summary of synced conversations

Best practices

• Always run the Telegram sync step before reading to ensure data is up to date
• Start with --last N to quickly inspect recent activity before broad searches
• Combine --topic with --search to limit results to a focused discussion thread
• Use --json when you plan to ingest results into a script or analysis tool
• Filter by date to narrow large history ranges and speed up queries

Example use cases

• Show the last 20 messages from the default synced group to catch up on recent discussion
• Search group history for the keyword "meeting" to find scheduling messages and decisions
• Export a topic's messages to JSON for sentiment analysis or archival
• Filter messages from a specific date to reconstruct what was discussed on that day
• Read announcements in a named topic to collect official updates