# Telegram Groups

> Posting, members, Telegram group management

- Skill: `aaaaqwq/telegram-groups` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aaaaqwq/telegram-groups`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aaaaqwq/telegram-groups/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aAAaqwq (https://skillmd.com/u/aaaaqwq)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aaaaqwq/telegram-groups

---

# Telegram Groups

> Operations with Telegram groups: listing, posting, members, management

## When to use

- "show my telegram groups"
- "post in a group"
- "add users to a group"
- "list group members"
- "rename a group"
- "create a topic"

## Tool

`$TG_TOOLS_PATH/tools/tg_groups.py`

## How to run

### List groups

```bash
# Groups only
python3 $TG_TOOLS_PATH/tools/tg_groups.py list

# Groups + channels
python3 $TG_TOOLS_PATH/tools/tg_groups.py list --all
```

### Post in a group

```bash
# Text directly
python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message "Hello!"

# From file
python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message-file msg.txt

# In a specific topic (forum group)
python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message "Hello!" --topic 123
```

Group Name -- search by substring (case-insensitive).

### List members

```bash
python3 $TG_TOOLS_PATH/tools/tg_groups.py members "Group Name"
```

### Add users

```bash
python3 $TG_TOOLS_PATH/tools/tg_groups.py add-users "Group Name" --input users.csv
```

CSV format: `username,name`

### Rename a group

```bash
python3 $TG_TOOLS_PATH/tools/tg_groups.py rename "Group Name" --name "New Name"
```

### Create a topic (forum group)

```bash
python3 $TG_TOOLS_PATH/tools/tg_groups.py topics "Group Name" --add "Topic Title"
python3 $TG_TOOLS_PATH/tools/tg_groups.py topics "Group Name" --add "Topic" --color 6FB9F0
```

## Limitations

- `add-users`: requires admin rights, mutual contact, privacy settings
- `rename`: requires admin rights
- `topics`: only for forum groups
- 2 sec delay between adding users (rate limit)

## Related skills

- `telegram-send` -- DM sending (not to a group)
- `telegram-scrape` -- searching channels/groups