Telegram Mechanic

Expert in Telegram Bot API, Webhooks, and Mini App Authentication.

9 stars 2 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add ydnikolaev/antigravity-factory --skill telegram-mechanic
Manual install
git clone --depth 1 https://github.com/ydnikolaev/antigravity-factory.git /tmp/antigravity-factory
mkdir -p ~/.claude/skills
cp -r /tmp/antigravity-factory/src/skills/telegram-mechanic ~/.claude/skills/telegram-mechanic

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Telegram Mechanic

> [!IMPORTANT]
> ## First Step: Read Project Config & MCP
> Before making technical decisions, **always check**:
> 
> | File | Purpose |
> |------|---------|
> | `project/CONFIG.yaml` | Stack versions, modules, architecture |
> | `mcp.yaml` | Project MCP server config |
> | `mcp/` | Project-specific MCP tools/resources |
> 
> **Use project MCP server** (named after project, e.g. `mcp_<project-name>_*`):
> - `list_resources` → see available project data
> - `*_tools` → project-specific actions (db, cache, jobs, etc.)
> 
> **Use `mcp_context7`** for library docs:
> - Check `mcp.yaml → context7.default_libraries` for pre-configured libs
> - Example: `libraryId: /nuxt/nuxt`, query: "Nuxt 4 composables"

This skill is the **Gateway**. It manages the Bot, Webhooks, and Security.

## Responsibilities
1.  **Bot API**: Menu setup, Commands, Deep Links.
2.  **Auth Security**: Validate `initData` string using HMAC-SHA256 (Go implementation).
3.  **Entry Point**: Ensure the Mini App opens correctly (`setChatMenuButton`).

## Team Collaboration
- **Architect**: `@bmad-architect` (Activates for TMA/Bot projects)
- **Backend**: `@backend-go-expert` (You provide the Auth Middleware logic)
- **TMA**: `@tma-expert` (You provide the `start_param` parsing)

## Workflow
1.  Register Bot in `@BotFather`.
2.  Configure Webhook (SSL required).
3.  Implement `POST /webhook` handler in Backend.
4.  Implement `initData` validation helper for Backend.

## When to Delegate
Read the full skill on GitHub

Details

Skill name
telegram-mechanic
Path
src/skills/telegram-mechanic/SKILL.md
Repo updated
28 January 2026

FAQ

What does the Telegram Mechanic skill do?

Expert in Telegram Bot API, Webhooks, and Mini App Authentication.

How do I install the Telegram Mechanic skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add ydnikolaev/antigravity-factory --skill telegram-mechanic. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Telegram Mechanic popular?

It lives in ydnikolaev/antigravity-factory, which has 9 GitHub stars and 2 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.