القائمة
Use when deciding which @yaebal/* package solves a problem in a yaebal bot — storage, keyboards, dialogs, rate limits, media, formatting, deployment, testing.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when building multi-step dialogs in a yaebal bot — choosing between scenes, conversation, and prompt, and wiring their persistence.
Use when writing or modifying a Telegram bot built on the yaebal framework — bot setup, handlers, filter queries, commands, and context typing.
Use when adding LLM features to a yaebal bot with @yaebal/ai — ctx.ai streaming replies, model adapters, conversation memory, and rate limits.
Use when writing a custom yaebal plugin — the Plugin<In, Out> contract, derive vs decorate, and typed plugin dependencies.
Use when a yaebal bot fails to compile, start, or respond — install-order type errors, ESM specifier errors, Telegram 400/409/429 responses.
Use when running a yaebal bot in production — long polling with @yaebal/runner vs webhooks with @yaebal/web, graceful shutdown, and error handling.
| name | yaebal-pick-plugin |
| description | Use when deciding which @yaebal/* package solves a problem in a yaebal bot — storage, keyboards, dialogs, rate limits, media, formatting, deployment, testing. |
reach for a first-party package before writing infrastructure by hand. installable plugins are
wired with bot.install(plugin()) — never bot.use(plugin()). some packages are libraries
(builders, functions) rather than plugins; those are noted below.
@yaebal/session — typed ctx.session, loaded before handlers and saved after (dirty-checked).
bot.install(session({ initial: () => ({ count: 0 }) })).@yaebal/sklad — the StorageAdapter contract + adapters (memory, redis, sqlite, cloudflare
kv, json file). not a plugin: pass an adapter to session/scenes/i18n/media-cache/ai.@yaebal/keyboard — InlineKeyboard / Keyboard builders. library, no install.@yaebal/callback-data — typed, compact callback_data schemas; routes via
bot.callbackQuery(namespace, handler). library, no install.@yaebal/pagination — paginated lists with ◀/▶ navigation that edit in place.
const list = pagination({...}); bot.install(list.plugin()).@yaebal/scenes — declarative step-by-step wizards, durable snapshots. bot.install(scenes({...})).@yaebal/conversation — linear await cv.waitFor(...) async flows. bot.install(conversation({...})).@yaebal/prompt — one-off question → handle the next message. bot.install(prompt()).@yaebal/commands — one registry for handlers + the / command menu, with sync() to push
the menu. const cmd = commands().add(...); bot.install(cmd.plugin()).@yaebal/router — file-based routing: load routes/commands/*.ts etc. via loadRoutes(bot, dir).@yaebal/throttle — outbound: queues your api calls under telegram's flood limits.
bot.install(throttle({ globalPerSec: 30 })).@yaebal/ratelimiter — inbound: drops update floods from spammy users.
bot.install(ratelimiter({ limit: 5, windowMs: 1000 })).@yaebal/again — autoRetry() re-runs failed api calls (429 retry_after, network errors).@yaebal/fmt — html / md tagged templates → entities, auto-escaped interpolation, no
parse_mode. library, no install.@yaebal/rich — telegram's block-tree rich messages (headings, tables, collages) via
sendRichMessage. library, no install.@yaebal/split — send >4096-char text as multiple messages: bot.install(splitter()) adds
ctx.sendLong / ctx.replyLong.@yaebal/files — bot.install(files()) adds ctx.files.info/url/download.@yaebal/file-id — parse/inspect file_id strings. library, no install.@yaebal/media-group — collect album parts into one handler call: bot.install(mediaGroup(handler)).@yaebal/media-cache — upload once, reuse file_id:
const cache = mediaCache(); bot.install(cache.plugin()).@yaebal/i18n — typed translations, ctx.t(...), plurals, locale persistence.
bot.install(i18n({ defaultLocale: "en", locales: { en, ru } })).@yaebal/payments — invoice builder + onPreCheckout/onSuccessfulPayment hooks (telegram
stars and providers). bot.install(payments({...})).@yaebal/broadcast — mass delivery with progress, retries and pause/resume:
await broadcast(bot.api, chatIds, text, options).@yaebal/ai — llm replies streamed into the chat: bot.install(ai({ model })) adds ctx.ai
(see the yaebal-ai-features skill).@yaebal/runner — concurrent long polling, ordered per chat: const handle = run(bot, {...}).@yaebal/web — webhooks on any runtime: webhook(bot), serve(bot), framework adapters,
sequentialize() / dedupe() hardening.@yaebal/test — createTestEnv + user/chat actors; no real HTTP ever. dev dependency.