telegram-mini-app · davila7 — Claude Code skill: features and installation
Plan Telegram Mini Apps with guidance on the Web App API, TON Connect, payments, and Telegram user data. Useful when building a web app that runs inside Telegram.
npx claude-code-templates@latest --skill enterprise-communication/telegram-mini-appWhat telegram-mini-app does
This skill covers Mini App structure, Telegram Web App API calls, and access to user information supplied by Telegram. It includes a basic HTML approach and a React hook pattern for reading user data and calling ready, expand, and close. A bot example shows how to open the app from a command.
For Web3 projects, the material walks through TON Connect setup in React, wallet connection, and sending a TON transaction. Other sections cover Telegram Stars invoices, referral links, and game rewards. These are implementation patterns, not a packaged Mini App. Validate Telegram initData; the skill flags skipping that check as a serious security issue.
The guidance also addresses Telegram themes, mobile-first layouts, and loading states. TON Connect on mobile is listed as a trouble spot, so test that flow on the phones you plan to support.
What it helps with
- wire the Telegram Web App API into an interface
- read Telegram user data in a Mini App
- connect a TON wallet and send a transaction
- add Telegram Stars payments through a bot
- create a referral flow for a Mini App
Example prompts for the agent
- Plan a React Mini App and add a hook for Telegram Web App data and controls.
- Set up TON Connect and add a button that sends a TON transaction.
- Add a Telegram Stars payment flow and a referral link to the app.
How to install telegram-mini-app
1claude-code-templates
npx claude-code-templates@latest --skill enterprise-communication/telegram-mini-app2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill telegram-mini-app -a claude-code3Manually: put the files in place
~/.claude/skills/telegram-mini-app/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/telegram-mini-app/
Manually: put the files in place
.agents/skills/telegram-mini-app/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/telegram-mini-app/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates telegram-mini-app2Manually: put the files in place
.github/skills/telegram-mini-app/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/enterprise-communication/telegram-mini-appManually: put the files in place
.devin/skills/telegram-mini-app/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about telegram-mini-app
How do I install telegram-mini-app in Claude Code?
Run npx claude-code-templates@latest --skill enterprise-communication/telegram-mini-app.
What does telegram-mini-app do?
It guides Claude Code through Telegram Mini App development, including the Web App API, Telegram user data, and TON Connect. It also covers payment and referral patterns.
What should I test when using TON Connect in a Mini App?
The skill identifies mobile TON Connect behavior as a trouble spot. Test wallet connection on the phones where the app will run.
Similar skills
SKILL.md skills catalog →telegram-mini-app by other authors comes first.