Run any Skill in Manus with one click

goyacodedevutils-yatgbot

Stars2

Forks0

UpdatedJuly 6, 2026 at 06:20

High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

YaCodeDev

YaCodeDev/GoYaCodeDevUtils

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	goyacodedevutils-yatgbot
description	High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot.

yatgbot Skill

Import path: github.com/YaCodeDev/GoYaCodeDevUtils/yatgbot.

High-level Telegram bot framework on top of gotd/td — router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Wires together yatgclient, yatgstorage, yafsm, yalocales, and yacache.

Key API

Options struct — all InitYaTgBot inputs: AppID/AppHash/BotToken/PoolDB/Cache/MainRouter/ParseMode/Log/Sync/Features/EmbeddedLocales/MessageQueueRatePerSecond/ForgetUpdatesOnStart.
InitYaTgBot(ctx, *Options) (Dispatcher, yaerrors.Error) — one-call bootstrap: parses the bot token, sets up FSM storage, localizer, GORM+Redis session/state storage, the gotd client, connects, authorizes, and starts updates.Manager.
Dispatcher struct — { FSMStore, Log, BotUser, MessageDispatcher, Localizer, Client, UpdatesErrors <-chan yatgclient.EntityError, MainRouter, Features } + Bind(tgDispatcher, sync bool).
RouterGroup struct + NewRouterGroup(); router.OnMessage/OnCallback/OnEditMessage/OnDeleteMessage/OnNewChannelMessage/OnEditChannelMessage/OnDeleteChannelMessages/OnMessageReactions/OnChannelParticipant/OnPrecheckoutQuery/OnInlineQuery(handler, filters...); RouterGroup.IncludeRouter(subs...), AddMiddleware(mw...).
Filter type + StateIs/TextEq/TextRegex/CallbackEq/CallbackPrefix/MessageServiceFilter/MessageServiceActionFilter[T]/OneOfFilter/AllOfFilter.
HandlerData struct — per-handler deps: Entities, Client, Update, UserID, Peer, StateStorage, Log, Dispatcher, Localizer, JobResults.
FeatureFlags (uint8) + const FeatureSequentialUpdates.
ExtractMessageFromUpdate/ExtractMessageServiceFromUpdate(upd) (*tg.Message/*tg.MessageService, bool).

Usage Notes

FeatureSequentialUpdates ensures async updates sharing a user/chat key are processed in arrival order via an internal scheduler; Options.Sync = true forces fully synchronous (blocking) dispatch instead.
Filters run root-router-first, then local/route filters; a handler can signal "not my type" via ErrRouteMismatch to fall through (used internally by wrapHandler's type assertion).
Heavily composes other packages: yacache (FSM + state storage), yafsm (per-user state), yalocales (per-user language via user.LangCode), yalogger, yatgclient (connection/auth), yatgmessageencoding (ParseMode), yatgstorage (session + updates.Manager state). Has an internal messagequeue subpackage not covered by its own skill.
Fx: Module (fx.go) provides *Dispatcher, deferring InitYaTgBot to an fx.Lifecycle OnStart hook (needs a live context); OnStop tears the connection down.

More from this repository

same repository

goyacodedevutils-catalog

YaCodeDev/GoYaCodeDevUtils

Index of every GoYaCodeDevUtils utility package (config, errors, logging, caching, rate limiting, backoff, hashing, gzip, RSA, feature flags, FSM, thread-safe collections, locales, Telegram bot stack) with a pointer to each package's own skill. Use before hand-rolling infrastructure code GoYaCodeDevUtils may already provide.

2026-07-062

goyacodedevutils-yatgclient

YaCodeDev/GoYaCodeDevUtils

Thin wrapper around gotd/td's telegram.Client adding background-connect-with-retry, bot-token authorization, updates.Manager wiring, and SOCKS5/MTProto proxy helpers. Use for direct low-level Telegram client control instead of raw gotd/td.

2026-07-062

goyacodedevutils-yatgstorage

YaCodeDev/GoYaCodeDevUtils

Redis-backed persistence for gotd/td's updates.Manager state (pts/qts/seq/date via RedisJSON) plus channel/user access-hash bookkeeping, and a GORM/AES-encrypted session-storage layer. Use for any yatgclient/yatgbot state or session persistence.

2026-07-062

goyacodedevutils-yacache

YaCodeDev/GoYaCodeDevUtils

Generic pluggable key-value cache abstraction with interchangeable in-memory and Redis backends, hash-oriented API. Use for any caching/session-store need instead of hand-rolling a map or a bare redis.Client call.

2026-07-062

goyacodedevutils-yalocales

YaCodeDev/GoYaCodeDevUtils

Loads JSON locale files into a nested key-tree with lookup, {placeholder} formatting, JSON serving, language-tag normalization, and Go-struct codegen. Use for any i18n/localization instead of hand-rolled JSON locale loading.

2026-07-062

goyacodedevutils-yatgmessageencoding

YaCodeDev/GoYaCodeDevUtils

Bidirectional converter between a custom Markdown-like syntax and Telegram (gotd) rich-text MessageEntityClass formatting, with correct UTF-16LE offsets. Use as the ParseMode for any yatgbot/gotd-based bot.

2026-07-062

name	goyacodedevutils-yatgbot
description	High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot.

yatgbot Skill

Import path: github.com/YaCodeDev/GoYaCodeDevUtils/yatgbot.

Key API

Options struct — all InitYaTgBot inputs: AppID/AppHash/BotToken/PoolDB/Cache/MainRouter/ParseMode/Log/Sync/Features/EmbeddedLocales/MessageQueueRatePerSecond/ForgetUpdatesOnStart.
InitYaTgBot(ctx, *Options) (Dispatcher, yaerrors.Error) — one-call bootstrap: parses the bot token, sets up FSM storage, localizer, GORM+Redis session/state storage, the gotd client, connects, authorizes, and starts updates.Manager.
Dispatcher struct — { FSMStore, Log, BotUser, MessageDispatcher, Localizer, Client, UpdatesErrors <-chan yatgclient.EntityError, MainRouter, Features } + Bind(tgDispatcher, sync bool).
RouterGroup struct + NewRouterGroup(); router.OnMessage/OnCallback/OnEditMessage/OnDeleteMessage/OnNewChannelMessage/OnEditChannelMessage/OnDeleteChannelMessages/OnMessageReactions/OnChannelParticipant/OnPrecheckoutQuery/OnInlineQuery(handler, filters...); RouterGroup.IncludeRouter(subs...), AddMiddleware(mw...).
Filter type + StateIs/TextEq/TextRegex/CallbackEq/CallbackPrefix/MessageServiceFilter/MessageServiceActionFilter[T]/OneOfFilter/AllOfFilter.
HandlerData struct — per-handler deps: Entities, Client, Update, UserID, Peer, StateStorage, Log, Dispatcher, Localizer, JobResults.
FeatureFlags (uint8) + const FeatureSequentialUpdates.
ExtractMessageFromUpdate/ExtractMessageServiceFromUpdate(upd) (*tg.Message/*tg.MessageService, bool).

Usage Notes

FeatureSequentialUpdates ensures async updates sharing a user/chat key are processed in arrival order via an internal scheduler; Options.Sync = true forces fully synchronous (blocking) dispatch instead.
Filters run root-router-first, then local/route filters; a handler can signal "not my type" via ErrRouteMismatch to fall through (used internally by wrapHandler's type assertion).
Heavily composes other packages: yacache (FSM + state storage), yafsm (per-user state), yalocales (per-user language via user.LangCode), yalogger, yatgclient (connection/auth), yatgmessageencoding (ParseMode), yatgstorage (session + updates.Manager state). Has an internal messagequeue subpackage not covered by its own skill.
Fx: Module (fx.go) provides *Dispatcher, deferring InitYaTgBot to an fx.Lifecycle OnStart hook (needs a live context); OnStop tears the connection down.