How do I install the Telegram skill?

Run npx skillmds add tools-only/telegram in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Telegram safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Telegram?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Telegram free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Telegram?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Telegram by tools-only — Agent Skill

Name: Telegram
Rating: 4.666666666666667 (3 reviews)
Author: tools-only

Process Telegram messages via GramJS MTProto client. Read messages, generate AI drafts, save drafts, and create intro groups. Use when handling Telegram conversations or facilitating introductions.

tools-only 1e9cd74 3 files · 6.5 KB Updated Sep 8, 2026 7 repo stars

File contents

Telegram Skill

Process Telegram messages via GramJS MTProto client. Supports unread messages, specific users, message requests, and group creation for introductions.

CRITICAL: NEVER SEND MESSAGES. Only save drafts.

Capabilities

Capability	Description
Unread Mode	Process N unread conversations
User Mode	Find specific person by username/name (any read state)
Requests Mode	Process message requests folder (non-contacts)
Entity Context	Load context from database for known contacts
Draft Replies	AI generates contextual reply drafts
Save Drafts	Save drafts to Telegram (no sending)
Create Groups	Create new groups and add members for introductions
Dialog Cache	Fast lookups via cached dialog IDs (~1s vs ~90s)
Mark Unread	Re-mark conversations as unread after processing
History	Save per-person history to vault `context/telegram/`

Workflows

workflows/process-messages.md - Full workflow for reading/replying
workflows/create-intro-group.md - Workflow for facilitating introductions

Tools

Script	Purpose
`scripts/telegram-gramjs.ts`	GramJS MTProto client - fetch messages, populate cache
`scripts/telegram-save-drafts.ts`	Save AI drafts to Telegram from work file
`scripts/save-telegram-draft.ts`	Quick helper to save one draft by username
`scripts/telegram-create-group.ts`	Create groups and add members for intros

Quick Reference

# Unread mode (default)
/cyber-telegram                    # 1 unread dialog
/cyber-telegram --count 3          # 3 unread dialogs

# User mode
/cyber-telegram --user "@username" # By username
/cyber-telegram --user "Name"      # By name

# Requests mode
/cyber-telegram --requests         # Message requests folder

# Modifiers
/cyber-telegram --dry-run          # Read only
/cyber-telegram --no-mark-unread   # Don't preserve unread state

# Create intro group
bun scripts/telegram-create-group.ts --dry-run --title "A <> B" --users "@user1,@user2"
bun scripts/telegram-create-group.ts --title "A <> B" --users "@user1,@user2" --draft "Intro message"

See workflow files for full documentation.

Dialog Cache

Dialog cache (~/.cybos/telegram/dialog-cache.json) stores all dialog IDs with access hashes for fast lookups:

Populated automatically during searches
Used by telegram-save-drafts.ts to avoid fetching all dialogs
~1 second draft save vs ~90 seconds without cache

Safety

Drafts only - never sends messages automatically. User reviews and sends manually in Telegram.

---name: telegramdescription: Process Telegram messages via GramJS MTProto client. Read messages, generate AI drafts, save drafts, and create intro groups. Use when handling Telegram conversations or facilitating introductions.---# Telegram SkillProcess Telegram messages via GramJS MTProto client. Supports unread messages, specific users, message requests, and group creation for introductions.**CRITICAL: NEVER SEND MESSAGES. Only save drafts.**## Capabilities| Capability | Description ||------------|-------------|| **Unread Mode** | Process N unread conversations || **User Mode** | Find specific person by username/name (any read state) || **Requests Mode** | Process message requests folder (non-contacts) || **Entity Context** | Load context from database for known contacts || **Draft Replies** | AI generates contextual reply drafts || **Save Drafts** | Save drafts to Telegram (no sending) || **Create Groups** | Create new groups and add members for introductions || **Dialog Cache** | Fast lookups via cached dialog IDs (~1s vs ~90s) || **Mark Unread** | Re-mark conversations as unread after processing || **History** | Save per-person history to vault `context/telegram/` |## Workflows- **`workflows/process-messages.md`** - Full workflow for reading/replying- **`workflows/create-intro-group.md`** - Workflow for facilitating introductions## Tools| Script | Purpose ||--------|---------|| `scripts/telegram-gramjs.ts` | GramJS MTProto client - fetch messages, populate cache || `scripts/telegram-save-drafts.ts` | Save AI drafts to Telegram from work file || `scripts/save-telegram-draft.ts` | Quick helper to save one draft by username || `scripts/telegram-create-group.ts` | Create groups and add members for intros |## Quick Reference```bash# Unread mode (default)/cyber-telegram # 1 unread dialog/cyber-telegram --count 3 # 3 unread dialogs# User mode/cyber-telegram --user "@username" # By username/cyber-telegram --user "Name" # By name# Requests mode/cyber-telegram --requests # Message requests folder# Modifiers/cyber-telegram --dry-run # Read only/cyber-telegram --no-mark-unread # Don't preserve unread state# Create intro groupbun scripts/telegram-create-group.ts --dry-run --title "A <> B" --users "@user1,@user2"bun scripts/telegram-create-group.ts --title "A <> B" --users "@user1,@user2" --draft "Intro message"```See workflow files for full documentation.## Dialog CacheDialog cache (`~/.cybos/telegram/dialog-cache.json`) stores all dialog IDs with access hashes for fast lookups:- Populated automatically during searches- Used by `telegram-save-drafts.ts` to avoid fetching all dialogs- ~1 second draft save vs ~90 seconds without cache## SafetyDrafts only - never sends messages automatically. User reviews and sends manually in Telegram.

Frequently asked questions