tg-ingest_skill

Overview

This skill is the primary Telegram interface for exporting messages, managing DMs, syncing groups, scoring contacts, and tracking thread state via a CLI. It provides fast syncs, one-shot exports, live continuous syncing, and utilities to prepare Telegram content for downstream AI workflows. Use it whenever you need reliable, scriptable access to Telegram conversation data or to manage thread lifecycle.

How this skill works

The tool communicates with Telegram via Telethon and stores session/auth data locally. It syncs DMs and whitelisted groups into structured exports (jsonl/markdown), maintains a contacts database with scoring, and records thread state in a decision log. CLI commands cover quick exports, full dumps, sync operations, group registry management, backfills, and live syncing.

When to use it

• Export recent messages for AI context or manual review
• Backfill or continuously sync DMs and selected groups
• Manage thread lifecycle (pending, done, archived, draft, snooze, note)
• Generate contact lists and priority scores from DM activity
• Add, list, or backfill group history for curated group archives

Best practices

• Use the quick export script for reading already-synced data rather than raw API dumps
• Keep TG_API_ID and TG_API_HASH in environment variables and secure the session file
• Whitelist only groups you need to reduce sync volume and storage
• Run periodic contact scoring to keep priorities up to date
• Backfill selectively with limits to avoid unnecessary API load

Example use cases

• Produce a markdown summary of the last 24 hours of a DM for an AI assistant prompt
• Sync all DMs nightly and run contact scoring to surface high-priority contacts
• Add a new group to the registry, backfill its history, and keep it in continuous sync
• Export a specific DM to jsonl for archival or downstream processing
• Run live sync during an event to capture messages in near real-time