Botxona

Working with AI assistants

Even if you're not a developer, you can use AI to write a bot that meets Botxona's requirements or adapt existing code. Pick one of the options below depending on which AI tool you use.

ChatGPT, Gemini or any chat AI

The simplest route: open the universal prompt in /ai-kit/prompt.md, copy it and send it to the AI together with your bot's code (or ask "I don't have a bot, write one for me"). The AI checks that the code follows Botxona's 6 rules and fixes it if needed. Ready-made tasks of the same kind are also available in the Prompt library — pick a bot idea there and copy it directly.

Claude Code (terminal)

If you use Claude Code, install it as a plugin — after that, just say "prepare my bot for Botxona":

/plugin marketplace add <url>
/plugin install botxona@botxona-uz

claude.ai or Claude Desktop

Upload /ai-kit/botxona-skill.zip via Settings → Capabilities → Skills → Upload skill — Claude can then analyze your bot right in the chat.

Cursor, Codex and similar coding agents

Put /ai-kit/AGENTS.md in the root folder of your bot's repository — these agents read it automatically and follow Botxona's rules.

Starting from zero — ready-made templates

If you have no code at all, download starter projects that already meet Botxona's standards: aiogram, python-telegram-bot, grammY, Telegraf and Go (go-telegram/bot) — then extend them with AI.

For developers

Offline check before uploading

python3 ai-kit/tools/botxona_pack.py /path/to/bot --check

This script builds the ZIP and checks size and file-count limits locally — no internet connection needed.

Public precheck API

To get only the check result without uploading the ZIP to the server:

curl -F file=@bot.zip https://botxona.uz/api/precheck

The response contains a full report on the 6 rules and security — the same one you get from a real upload, but no bot is created.

Contract for AI agents

If you're building your own AI agent or automation tool, /ai-kit/contract.md is the complete technical contract for working with Botxona in a machine-readable format, and /llms.txt is a short, AI-readable version of the site map.

Next step

Upload your code: Deploy your first bot in 10 minutes.