
Aiogram Framework
A focused skill for building Telegram bots with aiogram v3. It walks you through the standard setup decisions: polling versus webhooks, how to structure routers and handlers, where filters and middleware go, and when to reach for FSM for multi-step conversations. The workflow is sensible and matches how you'd actually architect a bot, from update delivery through error handling and utilities like keyboards and i18n. The reference docs cover the framework's core concepts without drowning you in API minutiae. If you're wiring up a Telegram bot and want guardrails that follow v3 patterns instead of StackOverflow answers from two versions ago, this keeps you on track.
- skills.sh installs
- 407
- GitHub stars
- 1
- last updated
- Aug 21, 2026
Install
$ npx -y skills add narumiruna/telegram-bot --skill aiogram-framework --agent claude-codeInstalls into .claude/skills of the current project.
Files
Aiogram Framework
Overview
Use this skill to design or modify aiogram-based bots in this repository with v3 patterns and the local docs/examples.
Workflow
- Choose update delivery (polling vs webhook) and note any scaling or multi-bot needs. See
references/updates.md. - Define dispatcher/router layout and handler registration. See
references/quickstart.mdandreferences/handlers-filters.md. - Add filters and context injection (including custom filters) as needed. See
references/handlers-filters.mdandreferences/middleware-di-errors.md. - Add middleware and error handling for cross-cutting concerns. See
references/middleware-di-errors.md. - Add FSM if the flow is multi-step or needs user state. See
references/fsm.md. - Use utilities (keyboards, formatting, i18n) where they reduce boilerplate. See
references/utils.md. - Cross-check with local examples under
examples/before finalizing.
Sponsors
Details
- Repository
- github.com/narumiruna/telegram-bot
- Categories
- Backend & APIs, DevOps & CI/CD, Code Review & Quality, Debugging
- First seen
- Jun 3, 2026