telegram-aiogram

Automate Telegram bot development workflows with aiogram 3.x.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/ziltorian/instructions --skill telegram-aiogram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-aiogram
Source: https://github.com/ziltorian/instructions/tree/main/.github/skills/telegram-aiogram
Command: npx skills add https://github.com/ziltorian/instructions --skill telegram-aiogram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building Telegram bots with aiogram 3.x can be challenging due to scattered code layouts, inconsistent patterns, and the need for robust FSM flows, routing, and testing. This skill delivers a structured guide and practical patterns to streamline bot development within a cohesive project structure.

Core Features & Use Cases

  • Structured module layout and ready-to-use patterns for bot components (bot.py, states.py, routers/, keyboards/, middleware/, utils/).
  • Reusable router and handler patterns with dependency injection and FSM integration for robust dialog flows.
  • Testing guidance covering tests/test_telegram*, tests/test_bot to validate Telegram functionality in real projects.

Quick Start

Follow the guide to scaffold aiogram 3.x Telegram bot components (bot.py, states.py, routers/, keyboards/, middleware/, and utils/) and start implementing handlers.

Frequently Asked Questions about telegram-aiogram

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

FAQPage Schema
How do I structure an aiogram 3.x Telegram bot project?

To structure an aiogram 3.x Telegram bot project, use a modular layout with dedicated directories for routers, keyboards, middleware, and utilities alongside centralized bot.py and states.py files.

Can I use FSM states and routers together in aiogram 3.x?

FSM states and routers work together in aiogram 3.x through reusable handler patterns with dependency injection, allowing you to build robust dialog flows within your Telegram bot.

What's the best way to test Telegram bot handlers in Python?

The best way to test Telegram bot handlers in Python is by following structured testing guidance targeting tests/test_telegram* and tests/test_*bot* patterns to validate aiogram 3.x functionality.

Does aiogram 3.x bot development require a specific Python version?

Aiogram 3.x bot development requires Python 3.13 or higher and targets Telegram Bot API 9.2, ensuring compatibility with the latest bot framework features and structured module layouts.

How do I implement middleware in a Telegram bot?

To implement middleware in a Telegram bot, place custom middleware classes in the dedicated middleware/ directory and register them within your aiogram 3.x router configuration.