Skip to content

stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/telegram-serverless

telegram-serverless

Verified

Build, review, deploy, and troubleshoot bots and Mini Apps on Telegram Serverless using tgcloud, its JavaScript SDK, and built-in database. Use when working on Telegram-hosted projects, handlers, endpoints, schema changes, or tgcloud operations; not generic Telegram bots hosted elsewhere or unrelated serverless platforms.

FileKindSize
SKILL.mdskill md8.7 KB
agents/openai.yamlconfig530 B
assets/openai-icon.pngbinary7.7 KB
assets/openai-icon.svgother708 B
references/database.mdmarkdown6.2 KB
references/mini-apps.mdmarkdown6.4 KB
references/operations.mdmarkdown7.4 KB
references/runtime-sdk.mdmarkdown4.4 KB
references/setup.mdmarkdown3.8 KB
references/sources.mdmarkdown13.1 KB

references/sources.md

View on GitHub
# Sources and coverage

Use official live sources for version-sensitive decisions. The [complete Telegram Serverless reference](https://core.telegram.org/bots/serverless) owns the platform contract; the project's generated SDK guide and installed CLI help/source supply version-specific detail. Maintainer source-review dates, package versions, and qualification limits live outside this skill in the repository's skill-evals evidence.

## Complete page coverage

| Official section                                                                                                                                                                                                                                                                                                                                                                     | Operational guidance                                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
| [Recent changes](https://core.telegram.org/bots/serverless#recent-changes), [October 6 additions](https://core.telegram.org/bots/serverless#october-6-2026)                                                                                                                                                                                                                          | Refresh platform/CLI evidence; setup layout and Mini App compatibility |
| [Why serverless](https://core.telegram.org/bots/serverless#why-serverless), [mental model](https://core.telegram.org/bots/serverless#the-mental-model), [quick demo](https://core.telegram.org/bots/serverless#quick-demo)                                                                                                                                                           | SKILL.md platform scope; runtime and separate deployment/migration     |
| [Getting started](https://core.telegram.org/bots/serverless#getting-started)                                                                                                                                                                                                                                                                                                         | setup.md and operations.md; all eight numbered steps mapped below      |
| [Create](https://core.telegram.org/bots/serverless#1-create-a-project), [link](https://core.telegram.org/bots/serverless#2-link-your-bot)                                                                                                                                                                                                                                            | setup.md                                                               |
| [Look around](https://core.telegram.org/bots/serverless#3-look-around), [deploy](https://core.telegram.org/bots/serverless#4-deploy)                                                                                                                                                                                                                                                 | operations.md                                                          |
| [Add a table](https://core.telegram.org/bots/serverless#5-add-a-database-table), [store/read](https://core.telegram.org/bots/serverless#6-store-and-read-data)                                                                                                                                                                                                                       | database.md                                                            |
| [Test](https://core.telegram.org/bots/serverless#7-test-without-deploying), [sync](https://core.telegram.org/bots/serverless#8-keep-in-sync)                                                                                                                                                                                                                                         | operations.md                                                          |
| [Building with AI](https://core.telegram.org/bots/serverless#building-with-ai), [BotFather](https://core.telegram.org/bots/serverless#on-the-go-with-botfather)                                                                                                                                                                                                                      | setup.md, project-instruction preservation and cloud divergence        |
| [Projects](https://core.telegram.org/bots/serverless#projects-and-modules), [anatomy](https://core.telegram.org/bots/serverless#anatomy-of-a-project), [modules](https://core.telegram.org/bots/serverless#the-module-system)                                                                                                                                                        | setup.md and runtime-sdk.md                                            |
| [Handlers](https://core.telegram.org/bots/serverless#handlers)                                                                                                                                                                                                                                                                                                                       | runtime-sdk.md                                                         |
| [Endpoints](https://core.telegram.org/bots/serverless#endpoints), [frontend calls](https://core.telegram.org/bots/serverless#calling-an-endpoint-from-the-mini-app)                                                                                                                                                                                                                  | mini-apps.md                                                           |
| [Deployment contents](https://core.telegram.org/bots/serverless#what-gets-deployed)                                                                                                                                                                                                                                                                                                  | operations.md and mini-apps.md                                         |
| [Mini App frontend](https://core.telegram.org/bots/serverless#mini-app-front-end)                                                                                                                                                                                                                                                                                                    | mini-apps.md, including every documented static option                 |
| [Database](https://core.telegram.org/bots/serverless#the-database), [tables](https://core.telegram.org/bots/serverless#declaring-tables)                                                                                                                                                                                                                                             | database.md                                                            |
| [Types](https://core.telegram.org/bots/serverless#column-types), [modifiers](https://core.telegram.org/bots/serverless#column-modifiers), [indexes/constraints](https://core.telegram.org/bots/serverless#indexes-and-constraints)                                                                                                                                                   | database.md; use official signatures for uncommon combinations         |
| [No foreign keys](https://core.telegram.org/bots/serverless#no-foreign-keys), [querying](https://core.telegram.org/bots/serverless#querying)                                                                                                                                                                                                                                         | database.md                                                            |
| [Migrations](https://core.telegram.org/bots/serverless#migrations), [removal](https://core.telegram.org/bots/serverless#removing-things), [type changes](https://core.telegram.org/bots/serverless#changing-a-column-39s-type)                                                                                                                                                       | database.md                                                            |
| [SDK](https://core.telegram.org/bots/serverless#the-sdk), [Bot API](https://core.telegram.org/bots/serverless#the-bot-api), [files](https://core.telegram.org/bots/serverless#files), [HTTP](https://core.telegram.org/bots/serverless#http), [logging](https://core.telegram.org/bots/serverless#logging)                                                                           | runtime-sdk.md                                                         |
| [CLI](https://core.telegram.org/bots/serverless#command-line-interface), [authentication](https://core.telegram.org/bots/serverless#authentication)                                                                                                                                                                                                                                  | setup.md and operations.md                                             |
| [init](https://core.telegram.org/bots/serverless#init), [add](https://core.telegram.org/bots/serverless#add), [login](https://core.telegram.org/bots/serverless#login), [completion](https://core.telegram.org/bots/serverless#completion)                                                                                                                                           | setup.md                                                               |
| [status](https://core.telegram.org/bots/serverless#status), [diff](https://core.telegram.org/bots/serverless#diff), [push](https://core.telegram.org/bots/serverless#push), [run](https://core.telegram.org/bots/serverless#run)                                                                                                                                                     | operations.md                                                          |
| [migrate](https://core.telegram.org/bots/serverless#migrate)                                                                                                                                                                                                                                                                                                                         | database.md, including flag conflicts and incomplete successful exits  |
| [fetch](https://core.telegram.org/bots/serverless#fetch), [pull](https://core.telegram.org/bots/serverless#pull), [reset](https://core.telegram.org/bots/serverless#reset), [webhook](https://core.telegram.org/bots/serverless#webhook), [upgrade](https://core.telegram.org/bots/serverless#upgrade), [staying in sync](https://core.telegram.org/bots/serverless#staying-in-sync) | operations.md                                                          |

## Linked primary references

- [Mini Apps Serverless API](https://core.telegram.org/bots/webapps#serverless): callback, error, and endpoint-call contract.
- [Mini App init data](https://core.telegram.org/bots/webapps#webappinitdata): context fields; frontend unsafe data is not backend authorization.
- [Bot API](https://core.telegram.org/bots/api): current update payloads, method parameters, errors, and media limits. Consult the needed method; do not mirror the entire API.
- [Published CLI metadata](https://registry.npmjs.org/@tgcloud%2Fcli/latest): version, engine requirement, and source archive location.
- [Published creator metadata](https://registry.npmjs.org/@tgcloud%2Fcreate-bot/latest): scaffold package identity and engine requirement.

## Limits and unresolved capabilities

Refresh the relevant official sections for file upload/download limits, HTTP response-size limits, supported updates, and static-hosting options. Streaming does not remove the documented size limits.

The referenced platform page does not establish runtime secret injection, transaction guarantees, invocation CPU/memory/time quotas, pricing/SLA, scheduler support, or backup/restore commands. Treat these as unresolved capabilities, not affirmative promises or proof of impossibility. If a requested design relies on one, identify the missing evidence and pause that dependent operation. Continue work that does not depend on it.

CLI source can resolve documented command behavior; it cannot establish unobserved server behavior. Remote execution with synthetic context cannot qualify platform authentication. Offline evaluation cannot qualify live hosting, database semantics, API delivery, or performance.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall