tg-responder — скилл для Claude Code: управление Telegram-ответами
Скилл tg-responder для Claude Code помогает проверять черновики ответов в Telegram, одобрять отправку и отслеживать сообщения без ответа, чтобы держать inbox под контролем и не забывать о важных переписках.
MIT 145 установок ★ 414 обновлён 2026-10-23
npx skills add glebis/claude-skills --skill tg-responder -a claude-codeЧто делает tg-responder
Скилл работает с тремя командами. /tg-responder review загружает чёрнки ответов из очереди — для каждого показывает исходное сообщение, предложенный ответ и даёт выбрать: отправить как есть, отредактировать или пропустить. /tg-responder status выводит статистику входящих и исходящих сообщений, последние активности. /tg-responder follow-ups ищет людей, которые не ответили на твои отправки, и отправляет им напоминания по экспоненциальному графику (3 дня, потом 6, потом 12).
Данные хранятся в SQLite-базе по адресу ~/Brains/data/telegram/responder.db. Скилл интегрируется с другим Telegram-скиллом, чтобы отправлять сообщения прямо из очереди. Для follow-ups нужна сессия Telethon — перед сканом свежих сообщений демон должен быть остановлен.
Внимание: автоответы вроде «Отвечу в ближайшее время!» не считаются реальными ответами и не закрывают follow-up. Скилл проверяет ID отправителя, чтобы не спутать твои собственные автоответы с сообщениями контакта.
Какие задачи решает
- просмотреть очередь черновиков ответов в Telegram
- одобрить или отредактировать ответ перед отправкой
- отследить, кто не ответил на исходящие сообщения
- отправить напоминания с автоматическим расписанием
- получить статистику входящих и исходящих сообщений
Примеры запросов агенту
- Покажи мне, какие черновики ответов ждут одобрения
- Проверь статус очереди Telegram-сообщений
- Напомни тем, кто не ответил на мои письма
Как установить tg-responder
1Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill tg-responder -a claude-code2Вручную: положить файлы
~/.claude/skills/tg-responder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tg-responder/
1Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill tg-responder -a codex2Вручную: положить файлы
.agents/skills/tg-responder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill tg-responder -a cursor2Вручную: положить файлы
.cursor/skills/tg-responder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install glebis/claude-skills tg-responder2Вручную: положить файлы
.github/skills/tg-responder/SKILL.md1Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill tg-responder -a gemini-cli2Командой платформы
gemini skills install https://github.com/glebis/claude-skills --path tg-responderВручную: положить файлы
.devin/skills/tg-responder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill tg-responder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tg-responder
Как установить tg-responder в Claude Code?
Выполни npx skills add glebis/claude-skills --skill tg-responder -a claude-code, потом открой ~/.claude/skills/tg-responder/SKILL.md.
Что делает tg-responder?
Управляет черновиками ответов в Telegram, помогает их одобрить и отправить, отслеживает сообщения, на которые никто не ответил, и отправляет напоминания по установленному графику.
Где хранятся данные скилла?
В SQLite-базе ~/Brains/data/telegram/responder.db. Конфиг находится в ~/.claude/skills/tg-responder/config.yaml.
Исходный текст
SKILL.md · MIT
---
name: tg-responder
description: Review and send Telegram response drafts, manage follow-ups for unanswered outbound messages. Use when the user says "/tg-responder review", "/tg-responder status", "/tg-responder follow-ups", "check telegram drafts", "review pending messages", "telegram inbox", "who hasn't replied", or "follow up".
---
# tg-responder — Telegram Communications Assistant
Review pending response drafts and manage the Telegram response queue.
## Commands
### review — Approve pending drafts
Read the responder queue and present drafts for approval:
```bash
python3 ~/.claude/skills/tg-responder/scripts/schema.py # ensure DB exists
```
Then query the database:
```sql
-- Pending drafts needing approval
SELECT o.id, o.chat_id, o.draft_text, o.draft_reason, o.source,
i.sender_name, i.text as original_text, i.urgency, i.category,
datetime(i.received_at, 'unixepoch') as received
FROM outbox o
JOIN inbox i ON o.inbox_id = i.id
WHERE o.status = 'draft'
ORDER BY
CASE i.urgency WHEN 'urgent' THEN 0 WHEN 'normal' THEN 1 ELSE 2 END,
o.created_at ASC;
```
For each draft, present to the user:
1. **Original message** — who sent it, when, what they said
2. **Draft response** — the proposed reply
3. **Options**: approve (send as-is), edit (modify then send), skip
To approve and send a draft:
1. Update outbox: `UPDATE outbox SET status = 'approved', final_text = draft_text, approved_at = strftime('%s','now') WHERE id = ?`
2. Send via telegram skill: `python3 ~/.claude/skills/telegram/scripts/telegram_fetch.py send --chat-id CHAT_ID --text "THE_TEXT"`
3. Update outbox with sent status and message_id
To skip: `UPDATE outbox SET status = 'skipped', updated_at = strftime('%s','now') WHERE id = ?`
### status — Queue statistics
```sql
-- Inbox stats
SELECT status, count(*) FROM inbox GROUP BY status;
-- Outbox stats
SELECT status, count(*) FROM outbox GROUP BY status;
-- Recent activity
SELECT sender_name, route, status, datetime(created_at, 'unixepoch')
FROM inbox ORDER BY created_at DESC LIMIT 10;
```
Report: pending count, drafts waiting, sent today, failed items.
### follow-ups — Track unanswered outbound messages
Scan for people who haven't replied, send reminders with exponential backoff.
```bash
# Scan for new unanswered messages (needs Telethon session — stop daemon first)
python3 ~/.claude/skills/tg-responder/scripts/follow_ups.py scan
# Process due reminders (drafts to Telegram or outbox)
python3 ~/.claude/skills/tg-responder/scripts/follow_ups.py remind
# List active follow-ups
python3 ~/.claude/skills/tg-responder/scripts/follow_ups.py list
# Archive expired follow-ups
python3 ~/.claude/skills/tg-responder/scripts/follow_ups.py archive
# Run all (scan + check replies + remind + archive)
python3 ~/.claude/skills/tg-responder/scripts/follow_ups.py all
```
Also query directly:
```sql
SELECT sender_name, outbound_text, reminder_count, max_reminders,
datetime(outbound_at, 'unixepoch') as sent,
datetime(next_reminder_at, 'unixepoch') as next_ping,
status
FROM follow_ups
WHERE status = 'active'
ORDER BY next_reminder_at;
```
Schedule: exponential (3d → 6d → 12d), fixed (every Nd), or custom per contact.
After max_reminders → archived. If they reply → auto-resolved.
## Database
Located at `~/Brains/data/telegram/responder.db`.
## Known Pitfalls
- **Auto-replies are not closers.** Messages like "Отвечу в ближайшее время!" are auto-respond placeholders, not real responses. Exclude them from follow-up resolution — they should not mark a thread as closed.
- **My messages vs. other people's messages.** The script can mistake the user's own auto-replies for the contact's messages, forming incorrect follow-up state. Always check sender ID, not just message content.
## Config
Located at `~/.claude/skills/tg-responder/config.yaml`. Edit contacts, modes, and ignore lists there.
## Worker
Start: `python3 ~/.claude/skills/tg-responder/scripts/worker.py`
One-shot: `python3 ~/.claude/skills/tg-responder/scripts/worker.py --once`
© glebis · MIT · glebis/claude-skills