Telegram Skill for Claude

The only Telegram skill your AI agent needs. Read messages, parse channels, download and transcribe voice notes — all via Telethon user API. One session file, zero bots. Use when user says 'read telegram', 'check saved messages', 'fetch from telegram', 'parse channel', 'transcribe voice', 'telegram search', 'check my telegram', or when any agent needs Telegram data. Also trigger on 'what did I save in telegram', 'read my saved messages', 'get messages from channel X', 'download voice notes'. Covers: ad-hoc reading, channel parsing with sanitization, voice/audio download. Requires TG_API_ID, TG

9 starsImages, Video & Audio

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add awrshift/skill-telegram --skill telegram

Manual install

git clone --depth 1 https://github.com/awrshift/skill-telegram.git /tmp/skill-telegram
mkdir -p ~/.claude/skills
cp -r /tmp/skill-telegram/. ~/.claude/skills/telegram

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 Skill — User API Integration

All operations via Telethon (user API, not bot API). One session file for everything.

## Setup (first run)

1. **Get API credentials** at https://my.telegram.org/apps → create app → copy `api_id` and `api_hash`
2. **Set env vars** in your `.env`:
   ```
   TG_API_ID=your_api_id
   TG_API_HASH=your_api_hash
   ```
3. **Install Telethon:** `pip install telethon`
4. **Run setup diagnostic:** `python3 scripts/tg_setup.py`
5. **Authenticate** (first time): `python3 scripts/tg_setup.py --auth` → enter phone + code from Telegram

Session file is saved automatically. All subsequent operations reuse it.

Set `TG_SESSION` env var to point to your session file, or the skill auto-discovers it.

## 1. Read Messages (any chat)

```bash
# Saved Messages
python3 scripts/tg_read.py --saved-messages --limit 10

# Specific chat/person
python3 scripts/tg_read.py --chat username --limit 20

# Public channel
python3 scripts/tg_read.py --channel SEOBAZA --limit 5

# With explicit session file
python3 scripts/tg_read.py --saved-messages --limit 5 --session /path/to/tg_session.session
```

Output: JSON lines (one per message) with: `id`, `date`, `text`, `has_voice`, `has_audio`, `has_photo`, `has_document`, `mime_type`, `file_size`, `duration`.

## 2. Parse Channels

Fetch messages from public channels with text sanitization (anti-injection, emoji cleanup, link extraction, dedup hashing).

Read the full skill on GitHub

Details

Skill name: telegram
Repository: awrshift/skill-telegram
License: MIT
Repo updated: 26 March 2026

FAQ

What does the Telegram skill do?

How do I install the Telegram skill?

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

Is Telegram popular?

It lives in awrshift/skill-telegram, which has 9 GitHub stars and 0 forks.

Related skills

Video Vision

Moh4696/claude-video-vision

Watch and understand local video files. Extracts sampled frames with ffmpeg and generates a timestamped transcript with local Whisper, then answers the user's question grounded in both visual and audio evidence. Use this skill whenever the user references a video file (.mp4, .mov, .mkv, .webm, .avi, .m4v) and wants it watched, summarized, analyzed, described, searched, captioned, transcribed, clipped, or asks questions like "what happens in this video", "what is said at 1:30", "find the part where X", "summarize this recording / lecture / meeting / clip", even if they don't explicitly say "wat

Images, Video & Audio

Mega Shot

stevenguyenbt/mega-shot

Makes finished narrated videos from an idea, driven by one video.yaml: researched, fact-checked script; narration in a cloned or built-in voice (local VoiceStudio TTS, voice cloning from any audio/video file); visuals in a style chosen with the user (stock footage and archival images, 2.5D parallax, whiteboard, flat 2D, kinetic type, 35 painterly styles, Three.js or Blender 3D, AI images, news graphics, satellite imagery, code-drawn story characters); music mix at -14 LUFS; high-quality export plus phone preview; automatic quality checks; English subtitles (SRT); YouTube thumbnails; publishing

Images, Video & Audio

Watch Video

Ootto-AI/ootto-watch

Give Claude eyes and ears on any online video, then analyze it. Downloads a video from a URL (YouTube, Instagram, X, Vimeo, and 1000+ yt-dlp sites), extracts key frames, and gets a transcript (native captions, else local Whisper), then hands the frames + timestamped transcript to Claude so it can produce a full breakdown — hook, format, storytelling structure, pacing and visual layout — grounded in what's actually on screen AND said. Pass several URLs to batch-analyze dozens at once and surface the patterns the best ones share. Use whenever the user shares a video link (or many) and wants it w

Images, Video & Audio

Jmcomic

NanNank0/JMComic_downloader

Use jmcomic (JMComic-Crawler-Python) to query JMComic metadata (album/photo details, search, rankings, comments) and to download albums or chapters, optionally exporting them to PDF, ZIP, or a long image. All commands return a single JSON object from one stable CLI entry point.

Images, Video & Audio

Aeon Music Video

AEON-7/aeon-music-video

Compose audio-reactive music videos from existing video clips and an audio track. USE THIS SKILL when the user wants to: build a music video from clips that react to the song's beats / onsets / spectral content, create rapid-cut hard-cut edits synced to a song, build a DMT-flash / Tron-aesthetic video, or compose a video where visuals respond to audio dynamics. Two scripts: reactive_compositor.py (general reactive editing across mood-bucketed clips) and dmt_flash_editor.py (10-cut hard-cut editor with chromatic aberration, bloom, and aggressive per-beat post-processing).

Images, Video & Audio

Fb Ad Video Studio

ai-agents-for-agencies-coaches/fb-ad-video-studio

Produce high-converting Facebook/Instagram/TikTok ad VIDEOS — motion-graphics spots and talking-head founder ads — by authoring HyperFrames HTML compositions and rendering to MP4. Opinionated layer on top of the HyperFrames framework that bakes in a battle-tested ad structure, the audio pipeline (VO + SFX + silence-cutting), caption sync, and a reverse-template workflow. Use whenever the user asks for a video ad, motion-graphics ad, founder/UGC ad, kinetic-typography spot, animated ad, Reel/Short ad, or "make a video like this ad". For raw HyperFrames framework questions use the `hyperframes`

Images, Video & Audio

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.