AI/ML

aiogram-framework

narumiruna/telegram-bot · updated Apr 8, 2026

$npx skills add https://github.com/narumiruna/telegram-bot --skill aiogram-framework
summary

Use this skill to design or modify aiogram-based bots in this repository with v3 patterns and the local docs/examples.

skill.md

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

  1. Choose update delivery (polling vs webhook) and note any scaling or multi-bot needs. See references/updates.md.
  2. Define dispatcher/router layout and handler registration. See references/quickstart.md and references/handlers-filters.md.
  3. Add filters and context injection (including custom filters) as needed. See references/handlers-filters.md and references/middleware-di-errors.md.
  4. Add middleware and error handling for cross-cutting concerns. See references/middleware-di-errors.md.
  5. Add FSM if the flow is multi-step or needs user state. See references/fsm.md.
  6. Use utilities (keyboards, formatting, i18n) where they reduce boilerplate. See references/utils.md.
  7. Cross-check with local examples under examples/ before finalizing.

Reference Map

  • Quickstart and project shape: references/quickstart.md
  • Update delivery details: references/updates.md
  • Routers/handlers/filters: references/handlers-filters.md
  • Middlewares, DI, errors: references/middleware-di-errors.md
  • FSM and storage: references/fsm.md
  • Utilities (keyboard/formatting/i18n): references/utils.md