telegram-session

$npx mdskill add aAAaqwq/AGI-Super-Team/telegram-session

Rebuild Telegram sessions when authentication fails or devices change.

  • Fixes SessionExpiredError and AuthKeyUnregisteredError instantly.
  • Integrates with tg-auth tools for session management.
  • Executes QR login or checks existing session files automatically.
  • Displays session details and lists all available session files.

SKILL.md

.github/skills/telegram-sessionView on GitHub ↗
---
name: telegram-session
description: Create/update Telethon session
---
# Infra Telegram Session

> Managing Telegram session via tg-auth

## When to use

- "telegram is not working"
- "SessionExpiredError" / "AuthKeyUnregisteredError"
- "check telegram session"
- First launch on a new device

## Tool

`$TG_TOOLS_PATH/tools/tg_auth.py`

## How to execute

### Check session

```bash
python3 $TG_TOOLS_PATH/tools/tg_auth.py check
```

Shows: name, username, phone + last 10 chats.

### QR Login (new session)

```bash
# QR + wait for scan (2 min timeout)
python3 $TG_TOOLS_PATH/tools/tg_auth.py qr

# Only show QR (without waiting)
python3 $TG_TOOLS_PATH/tools/tg_auth.py qr --no-wait
```

On phone: Settings > Devices > Link Desktop Device > scan QR.

### List sessions

```bash
python3 $TG_TOOLS_PATH/tools/tg_auth.py sessions
```

Shows all `.session` files in the sessions directory.

### Custom session

```bash
python3 $TG_TOOLS_PATH/tools/tg_auth.py --session /path/to/session check
```

## Paths

| What | Path |
|------|------|
| Default session | `$SALES_PATH/telegram/sessions/telegram_session.session` |
| ENV | `$SALES_PATH/.env` |

## Troubleshooting

| Problem | Solution |
|---------|----------|
| SessionExpiredError | `tg-auth qr` -- create a new session |
| AuthKeyUnregisteredError | `tg-auth qr` -- re-login |
| "Not authorized" | `tg-auth qr` |
| FloodWaitError | Wait the specified time |
| QR timeout | Run `tg-auth qr` again |

## Related skills

- `telegram-send` -- sending messages
- `telegram-check` -- checking replies

More from aAAaqwq/AGI-Super-Team

SkillDescription
a-fund-monitor监控 A 股基金实时估值与盘后净值，自动判断交易日并生成提醒或分析。
add-leadAdd company/person/relationship to CRM
ads-agentAI-агент для управления Facebook рекламой. Вызывай для анализа, оптимизации, создания кампаний и отчётов.
afrexai-compliance-auditRun internal compliance audits against major governance and security
afrexai-personal-financeComplete personal finance system — budgeting, debt payoff, investing, tax optimization, net worth tracking, and financial independence planning. Use when managing money, building wealth, paying off debt, planning retirement, or optimizing taxes. Zero dependencies.
after-salesUse when managing post-purchase experience, building customer loyalty, or increasing repeat purchases
agent-contactsAI agent contacts — add, list, remove MCP contacts. Use when someone gives an agent URL, or when you need to view/remove contacts.
agent-model-switcher批量查看和切换子 agent 的模型配置，用于统一调整多 agent 的 provider/model 设置。
agent-patternsFormat SPAWN REQUEST messages to launch parallel agents, generate structured agent status reports, and define communication protocols within the sprint system. Use when the user needs to coordinate multiple agents, format spawn requests, produce agent reports, or establish inter-agent communication patterns.
agent-task-confirmUse when confirming whether a dispatched agent task was actually received, activated, and progressing after sessions_send or other task handoff actions.