ReddRadar
Agent skill
telegram
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/telegram
SKILL.md
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/replyingworkflows/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.tsto 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?