telegram-bot

Build Telegram bots with aiogram 3.x FSM, dialogs, scenes, and i18n.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/snqb/my-skills --skill telegram-bot-snqb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-bot
Source: https://github.com/snqb/my-skills/tree/main/telegram-bot
Command: npx skills add https://github.com/snqb/my-skills --skill telegram-bot-snqb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building robust, scalable Telegram bots is challenging when coordinating FSMs, dialogs, scenes, and localization across multiple libraries. This skill provides a cohesive blueprint to implement production-ready bots using aiogram 3.x ecosystem.

Core Features & Use Cases

  • FSM-driven multi-step conversations for onboarding, surveys, and workflows.
  • aiogram-dialog for GUI-like windows and reusable widgets, enabling complex UIs within Telegram.
  • Scenes for isolated, multi-step workflows with clear entry/exit lifecycles.
  • aiogram-i18n for multi-language support and runtime translations.
  • Modular routing, middleware patterns, and production-ready architecture for maintainable bots.
  • Use Case: Build a customer support bot with menus, dialogs, and translations that scales with your team.

Quick Start

Install aiogram and the related libraries, then run a minimal bot using your Telegram token to see a production-ready template.

Frequently Asked Questions about telegram-bot

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

FAQPage Schema
How do I build a Telegram bot with multi-step conversations using aiogram FSM?

Build Telegram bots with aiogram FSM by defining state groups for workflows like onboarding or surveys. This skill provides a production-ready blueprint using aiogram 3.x to manage multi-step conversations and isolate state lifecycles effectively.

What is the best way to create GUI-like menus and dialogs in Telegram bots?

Create GUI-like interfaces in Telegram bots using aiogram-dialog. This skill demonstrates how to implement reusable widgets and complex windows within Telegram, enabling structured user interfaces without external web apps.

How do I add internationalization to an aiogram 3.x bot?

Add internationalization to an aiogram 3.x bot using the aiogram-i18n library. This skill covers runtime translations and multi-language support, allowing your bot to serve users in different languages seamlessly.

Do I need Python 3.7 to use aiogram-dialog and aiogram-i18n for bot development?

Yes, you need Python 3.7 or higher to use this aiogram 3.x stack. The skill requires Python 3.7+ alongside aiogram, aiogram-dialog, and aiogram-i18n to implement robust, maintainable bot architectures.

When should I use scenes instead of standard FSM in aiogram?

Use scenes in aiogram for isolated, multi-step workflows with clear entry and exit lifecycles. This skill shows how scenes provide modular routing and state management for complex bot architectures compared to standard FSM.