Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

telegram-mini-app — Claude Code skill: build Telegram Mini Apps

Skill for developing Telegram Mini Apps—web applications that run inside Telegram with a native-like experience. Covers Telegram Web App API, TON ecosystem, user authentication, and monetization through Telegram Stars.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add sickn33/agentic-awesome-skills --skill telegram-mini-app -a claude-code
Open on GitHub

What telegram-mini-app does

This skill teaches the complete TWA stack: Telegram Web App API integration, TON Connect, digital goods payments via Telegram Stars, and Mini App architecture. It helps you design apps within Telegram's actual client capabilities, viral mechanics, and platform rules.

Inside the skill: Mini App architecture, mobile UX patterns, how Telegram Stars differ from other payment flows (only for digital goods), user authentication through Telegram, and TON blockchain integration. Understand that a Mini App is a web app running in Telegram's browser—it has specific limits and peculiarities.

Before using this skill, read the detailed guide at references/detailed-guide.md. It outlines prerequisites, safety checks, and success criteria. Ask for clarification if required inputs, permissions, or boundaries are unclear.

What it helps with

  • build a web app inside Telegram with access to user profile
  • integrate payments using Telegram Stars for digital goods
  • connect a wallet or handle TON blockchain transactions
  • design viral mechanics to drive Mini App adoption
  • adapt UI for Telegram's browser constraints

Example prompts for the agent

  • Help me design a Mini App for a game with built-in payments via Telegram Stars
  • Show how to integrate TON Connect into my Mini App
  • How do I add Telegram Web App API authentication to my frontend?

How to install telegram-mini-app

1Skills CLI (Vercel)

npx skills add sickn33/agentic-awesome-skills --skill telegram-mini-app -a claude-code

2Manually: put the files in place

~/.claude/skills/telegram-mini-app/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/telegram-mini-app/

From the same set80

The whole set →
docker-expert sickn33 A skill that turns your AI agent into a Docker reviewer for Dockerfiles, multi-stage builds and container security. Useful when images and Compose files need a second look. Claude Code CX Codex Cursor +1 27,200installs typescript-expert sickn33 A skill for TypeScript and JavaScript work: it reads your project setup, fixes type errors and speeds up type checking. Useful once a TS codebase gets big. Claude Code CX Codex Cursor +1 12,600installs browser-automation sickn33 This skill builds browser checks around observed UI state and explicit outcomes. Use it for UI workflows, timing failures, or authorised page-data collection. Claude Code CX Codex Cursor +1 6,700installs nextjs-supabase-auth sickn33 This skill wires Supabase Auth into the Next.js App Router with clients, middleware, OAuth callbacks, and Server Actions. Use it when you need protected routes and session handling. Claude Code CX Codex Cursor +1 6,500installs 3d-web-experience sickn33 Helps build and debug web 3D scenes, product configurators, and portfolios. Covers stack choice, model loading, scroll interaction, and performance checks. Claude Code CX Codex Cursor +1 5,200installs prisma-expert sickn33 This skill helps inspect Prisma schemas, migrations, and queries. Use it to investigate an error or review database changes before deployment. Claude Code CX Codex Cursor +1 4,200installs playwright-skill sickn33 Write and run Playwright browser tests directly in Claude Code: responsive design checks, login flows, form submissions, screenshots. Executes locally via Node with a visible browser window. Claude Code CX Codex Cursor +1 3,900installs game-development sickn33 Guides game architecture decisions, platform choices, and core loop structure. Directs the assistant to specialized sub-skills for web, mobile, PC, or VR. Claude Code CX Codex Cursor +1 3,800installs

Similar

pretext Hermes Agent A skill for browser demos built on @chenglou/pretext: text wraps around shapes, splits into graphemes and gets measured through canvas without a page reflow. Claude Code CX Codex Cursor +1 317installs vue-expert https://github.com/Jeffallan Guides Vue 3 work with the Composition API, Nuxt 3, Pinia, and Vite. Use it for components, PWAs, and Quasar or Capacitor apps. Claude Code CX Codex Cursor +1 4,500installs sprites-and-images phaserjs Guides agents on creating Sprite and Image objects in Phaser 4. Explains factory methods, texture frames, mixin components, and visual transforms. Claude Code CX Codex Cursor +1 1,100installs zod-4 prowler-cloud Provides validation patterns for Zod 4 and guides migration from Zod 3. It helps write schemas for forms, API payloads, and adapters. Claude Code CX Codex Cursor +1 1,200installs html-diagram plannotator Generates standalone interactive HTML diagrams without external services or build steps. Helps visualize component topology, state transitions, timelines, and quantitative structures. Claude Code CX Codex Cursor +1 4,100installs frontend-design official anthropics This skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. Claude Code Claude.ai 1,025,790installs design-taste-frontend Leonxlnx This skill directs the design of public pages and work screens, then checks the result in a browser through screenshots. Use it when an interface feels generic or unfinished. Claude Code CX Codex Cursor +1 673,100installs prototype Matt Pocock Creates throwaway prototypes for checking state logic or exploring UI before committing the decision to the main codebase. Claude Code 986,201installs

Questions about telegram-mini-app

How do I install telegram-mini-app in Claude Code?

Run npx skills add sickn33/agentic-awesome-skills --skill telegram-mini-app -a claude-code. The skill will be available at ~/.claude/skills/telegram-mini-app/SKILL.md.

What does telegram-mini-app do?

This skill prepares you to build web apps inside Telegram with TON integration, Telegram Stars payments, user authentication, and viral distribution mechanics, accounting for the actual capabilities of Telegram's client browser.

Do Telegram Stars work with all payment types or only certain ones?

Telegram Stars are limited to digital goods inside Mini Apps. They're not a universal payment method—the skill distinguishes Stars from other payment flows and helps you pick the right approach.

Source text

SKILL.md · MIT 
---
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.
risk: critical
source: vibeship-spawner-skills (Apache 2.0)
date_added: 2026-02-27
---

# Telegram Mini App

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.

**Role**: Telegram Mini App Architect

Design for the actual Telegram client capabilities, audience and verified platform rules. Distinguish digital-goods Stars payments from other permitted payment or wallet flows; do not infer demand or revenue from Telegram’s overall audience.

### Expertise

- Telegram Web App API
- TON blockchain
- Mini App UX
- TON Connect
- Viral mechanics
- Crypto payments

## Detailed Guide

Read [the detailed guide](references/detailed-guide.md) before executing this skill. It retains the complete procedure and reference material. Treat its safety, prerequisites, and validation requirements as mandatory. For focused work, load the relevant sections; for end-to-end work, read the guide completely.

## When to Use
- User mentions or implies: telegram mini app
- User mentions or implies: TWA
- User mentions or implies: telegram web app
- User mentions or implies: TON app
- User mentions or implies: mini app

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

© sickn33 · MIT · sickn33/agentic-awesome-skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor