How do I install the Tg skill?

Run npx skillmds@latest add modbender/tg 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.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. 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 Tg?

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.

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

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

Tg by modbender — Agent Skill

Name: Tg
Rating: 4.5 (4 reviews)
Author: modbender

File contents

Telegram CLI

Fast Telegram CLI for reading, searching, and sending messages.

When to Use

Use this skill when the user:

Asks to check Telegram messages or inbox
Wants to search Telegram for a topic/keyword
Wants to send a Telegram message to someone
Asks about a Telegram group, contact, or chat
Wants to see unread messages
Needs to look up group members or admins

Install

npm install -g @cyberdrk/tg

Or from source:

cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link

Authentication

First-time setup requires API credentials from https://my.telegram.org/apps

tg auth

Commands

Reading

tg inbox                               # Unread messages summary
tg chats                               # List all chats
tg read "ChatName" -n 50               # Read last 50 messages
tg read "ChatName" --since "1h"        # Messages from last hour
tg read @username -n 20                # Read DM with user
tg search "query" --chat "ChatName"    # Search within chat
tg search "query" --all                # Search all chats

Writing

tg send @username "message"            # Send DM
tg send "GroupName" "message"          # Send to group
tg reply "ChatName" 12345 "response"   # Reply to message ID

Contacts & Groups

tg contact @username                   # Get contact info
tg members "GroupName"                 # List group members
tg admins "GroupName"                  # List admins only
tg groups --admin                      # Groups where you're admin

Status

tg whoami                              # Show logged-in account
tg check                               # Verify session

Output Formats

All commands support --json for structured output suitable for processing:

tg inbox --json                        # JSON format
tg read "Chat" --json                  # JSON with messages array
tg chats --json                        # JSON with chat list

Examples

Check inbox:

tg inbox

Read recent messages from a chat:

tg read "MetaDAO Community" -n 20

Search for a topic:

tg search "futarchy" --chat "MetaDAO"

Send a message:

tg send @username "Hello, checking in!"

Notes

Chat names can be partial matches (e.g., "MetaDAO" matches "MetaDAO Community")
Usernames must start with @ (e.g., @username)
Messages are returned in reverse chronological order (newest first)
The --since flag accepts formats like "1h", "30m", "7d"

---name: tgdescription: Telegram CLI for reading, searching, and sending messages. Use when the user asks about Telegram messages, wants to check inbox, search chats, send messages, or look up contacts and groups.--- # Telegram CLI Fast Telegram CLI for reading, searching, and sending messages. ## When to Use Use this skill when the user: - Asks to check Telegram messages or inbox - Wants to search Telegram for a topic/keyword - Wants to send a Telegram message to someone - Asks about a Telegram group, contact, or chat - Wants to see unread messages - Needs to look up group members or admins ## Install ```bash npm install -g @cyberdrk/tg ``` Or from source: ```bash cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link ``` ## Authentication First-time setup requires API credentials from https://my.telegram.org/apps ```bash tg auth ``` ## Commands ### Reading ```bash tg inbox # Unread messages summary tg chats # List all chats tg read "ChatName" -n 50 # Read last 50 messages tg read "ChatName" --since "1h" # Messages from last hour tg read @username -n 20 # Read DM with user tg search "query" --chat "ChatName" # Search within chat tg search "query" --all # Search all chats ``` ### Writing ```bash tg send @username "message" # Send DM tg send "GroupName" "message" # Send to group tg reply "ChatName" 12345 "response" # Reply to message ID ``` ### Contacts & Groups ```bash tg contact @username # Get contact info tg members "GroupName" # List group members tg admins "GroupName" # List admins only tg groups --admin # Groups where you're admin ``` ### Status ```bash tg whoami # Show logged-in account tg check # Verify session ``` ## Output Formats All commands support `--json` for structured output suitable for processing: ```bash tg inbox --json # JSON format tg read "Chat" --json # JSON with messages array tg chats --json # JSON with chat list ``` ## Examples Check inbox: ```bash tg inbox ``` Read recent messages from a chat: ```bash tg read "MetaDAO Community" -n 20 ``` Search for a topic: ```bash tg search "futarchy" --chat "MetaDAO" ``` Send a message: ```bash tg send @username "Hello, checking in!" ``` ## Notes - Chat names can be partial matches (e.g., "MetaDAO" matches "MetaDAO Community") - Usernames must start with @ (e.g., @username) - Messages are returned in reverse chronological order (newest first) - The `--since` flag accepts formats like "1h", "30m", "7d"

Frequently asked questions

Tg