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

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 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.

Search AI Tools

telegram

Install this agent skill to your Project

SKILL.md