telegram-gateway-debug-loop

Simulate end-to-end Telegram conversations to diagnose lemon gateway reliability issues.

130|16|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/z80dev/lemon --skill telegram-gateway-debug-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-gateway-debug-loop
Source: https://github.com/z80dev/lemon/tree/main/.claude/skills/telegram-gateway-debug-loop
Command: npx skills add https://github.com/z80dev/lemon --skill telegram-gateway-debug-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug and stress-test lemon gateway by simulating Telegram conversations on both sides, enabling visibility into logs and runtime state during end-to-end runs.

Core Features & Use Cases

  • End-to-end Telegram traffic simulation to exercise gateway behavior and routing.
  • Live observation of gateway logs, metrics, and runtime state during stress tests.
  • Repro scenarios for stuck runs, delivery failures, scheduler/lock contention, async delegation bugs, and context overflows, with guided remediation.

Quick Start

Run the gateway in debug mode and connect Telethon with test credentials to simulate end-to-end Telegram conversations.

Frequently Asked Questions about telegram-gateway-debug-loop

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

FAQPage Schema
How do I debug a Telegram gateway with stuck runs and delivery failures?

Debug a Telegram gateway by simulating end-to-end conversations with Telethon to observe runtime state and logs. This visibility helps reproduce stuck runs, delivery failures, and scheduler contention for guided remediation.

How do I stress-test a Telegram gateway end-to-end?

Stress-test a Telegram gateway by running debug-enabled binaries and connecting Telethon with test credentials to simulate live traffic. This exercises routing behavior and exposes async delegation bugs under load.

Can I use Telethon to reproduce context overflows in a live gateway deployment?

Yes, you can use Telethon to simulate Telegram conversations that trigger context overflows in live gateway deployments. Observing the runtime state during these tests reveals exactly where the gateway fails to handle context limits.

Do I need debug-enabled gateway binaries to diagnose scheduler and lock contention?

Yes, debug-enabled gateway binaries are required to observe internal runtime state and log propagation. This access is necessary to accurately diagnose scheduler and lock contention during simulated Telegram traffic.

What is the best way to observe runtime state during Telegram gateway stress tests?

The best way to observe runtime state is by simulating end-to-end Telegram conversations on both sides using Telethon. This provides live visibility into gateway logs, metrics, and internal state during the stress test.

Why does my Telegram gateway have async delegation bugs during live traffic?

Async delegation bugs occur when the gateway fails to handle concurrent Telegram traffic correctly. Simulating end-to-end conversations with Telethon exposes these runtime state issues and log propagation failures for guided remediation.