telegram-issue-sync

Syncs Telegram supergroup messages into local task files and GitHub issues.

6|Updated May 18, 2026
One-click install
npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill telegram-issue-sync-mokhtarabadi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: telegram-issue-sync
Source: https://github.com/mokhtarabadi/cognitive-lead-hq/tree/main/skill-templates/telegram-issue-sync
Command: npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill telegram-issue-sync-mokhtarabadi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Actionable bug reports and feature requests posted in Telegram supergroup topics get lost or paraphrased when manually converted into development tasks. This Skill automates the conversion of raw Telegram messages into structured local task files and GitHub issues while preserving the original message verbatim. ## Core Features & Use Cases - Topic-Scoped Message Crawling: Fetches Telegram history, filters messages by forum topic via reply-chain walking, and detects bug/feature/improve candidates by hashtag. - Zero-Summarization Task Generation: Creates bilingual task files containing the verbatim original message, a full English translation, a refactored prompt, codebase context, and AI analysis. - Deterministic State Management: Uses an embedded Python updater script to atomically track processed message IDs and sync registry entries in telegram-sync.json. - Use Case: A manager posts a Persian bug report in a Telegram project topic; the Skill crawls the topic, asks for approval, generates a task file in tasks/backlog/, optionally creates a GitHub issue, and replies in Telegram with the result. ## Quick Start Ask the agent to run the telegram-issue-sync workflow to fetch new messages from the configured Telegram topic and turn the approved ones into task files and GitHub issues.

Frequently Asked Questions about telegram-issue-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Telegram messages to GitHub issues?▼

Configure telegram-sync.json with your chat_id and topic_id, then run the sync workflow. It fetches topic messages, filters candidates by hashtags like bug or feature, asks for approval, and creates GitHub issues via the gh CLI.

How to filter Telegram messages by forum topic?▼

Telegram's API has no server-side topic filter, so the workflow fetches full chat history and client-filters by the reply_to field. For nested replies, it walks the reply chain until it reaches the topic root message ID.

Does the sync preserve the original message text?▼

Yes, the workflow enforces zero-summarization: the raw message is stored immediately after fetching and written verbatim into an Original Message section, with a separate English Translation section so the source text is never altered.

What happens if GitHub issue creation fails?▼

The workflow degrades gracefully: the GitHub URL defaults to a failure placeholder, but the local task file is still generated and the Telegram confirmation reply is still sent, so no synced work is lost.

How does the sync avoid processing the same message twice?▼

A Python updater script atomically writes last_processed_message_id and a processed_ids list into telegram-sync.json after each sync. Only messages with IDs greater than the last processed ID are fetched in subsequent runs.