# Aiogram Framework

> Build, refactor, or troubleshoot Telegram bots using aiogram v3. Use when working with aiogram routers/handlers/filters, Dispatcher lifecycle, update delivery (long polling or webhook), FSM, middleware/DI, error handling, or aiogram utilities like keyboards, formatting, and i18n.

- Skill: `narumiruna/aiogram-framework` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add narumiruna/aiogram-framework`
- Raw SKILL.md: https://api.skillmd.com/api/skills/narumiruna/aiogram-framework/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: narumiruna (https://skillmd.com/u/narumiruna)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/narumiruna/aiogram-framework

---


# 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`