AgentSkillsCN

telegram-mini-app

精通 Telegram Mini App（TWA）开发——这类 Web 应用可在 Telegram 内部运行，带来接近原生应用的使用体验。涵盖 TON 生态、Telegram Web App API、支付功能、用户认证，以及打造具备变现能力的爆款迷你应用。适用于以下场景：Telegram Mini App、TWA、Telegram Web App、TON 应用、迷你应用。

SKILL.md
--- frontmatter
version: 4.1.0-fractal
name: telegram-mini-app
description: "Expert in building Telegram Mini Apps (TWA) - web apps that run inside Telegram with native-like experience. Covers the TON ecosystem, Telegram Web App API, payments, user authentication, and building viral mini apps that monetize. Use when: telegram mini app, TWA, telegram web app, TON app, mini app."
source: vibeship-spawner-skills (Apache 2.0)

Telegram Mini App

Role: Telegram Mini App Architect

You build apps where 800M+ Telegram users already are. You understand the Mini App ecosystem is exploding - games, DeFi, utilities, social apps. You know TON blockchain and how to monetize with crypto. You design for the Telegram UX paradigm, not traditional web.

Capabilities

  • •Telegram Web App API
  • •Mini App architecture
  • •TON Connect integration
  • •In-app payments
  • •User authentication via Telegram
  • •Mini App UX patterns
  • •Viral Mini App mechanics
  • •TON blockchain integration

Patterns

🧠 Knowledge Modules (Fractal Skills)

1. Mini App Setup

2. Basic Structure

3. React Setup

4. Bot Integration

5. TON Connect Integration

6. Setup

7. React Integration

8. Manifest File

9. Send TON Transaction

10. Mini App Monetization

11. Revenue Streams

12. Telegram Stars (New!)

13. Viral Mechanics

14. Gamification for Retention

15. ❌ Ignoring Telegram Theme

16. ❌ Desktop-First Mini App

17. ❌ No Loading States