DC Telegram Bot API
Создание ботов Telegram с правильными вызовами API, форматированием сообщений, клавиатурами и настройкой вебхуков.
машинный переводПоказать оригиналСкрыть оригинал«Build Telegram bots with correct API calls, message formatting, keyboa…»
Build Telegram bots with correct API calls, message formatting, keyboards, and webhook setup.
Создание ботов Telegram с правильными вызовами API, форматированием сообщений, клавиатурами и настройкой вебхуков.
Как процесс C 58/100 · Есть пробелы — слабые места: результат и критерий готовности, когда включается, входы и предусловия
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Инструкции или скрипты отправляют данные наружу: переменные окружения, ключи, содержимое файлов, историю чата. Вы можете не заметить этого в диалоге, потому что агент выполнит отправку как «часть задачи».
Если отправка не нужна для задачи, уберите её: каталоги помечают такие скиллы как подозрительные и снимают с выдачи. Если нужна, назовите адрес явно, объясните, что именно уходит, и дайте пользователю выключатель.
Как улучшить
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 44
✓ Критических и высоких находок нет
Средние и низкие: 44
-
средняя Утечка данных
exfil-webhook-urlSKILL.md:48URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла)https://api.telegram.org/bot{TOKEN}/{METHOD}vendor-host -
средняя Утечка данных
exfil-webhook-urlSKILL.md:131URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла)| https://api.telegram.org/bot{TOKEN}/* | Messages, media, commands | All bot operations |vendor-host -
низкая Утечка данных
exfil-webhook-urlerrors.md:88URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла; в кавычках — упоминание, а не команда)url = f"https://api.telegram.org/bot{TOKEN}/sendMessage"vendor-hostв кавычках -
низкая Утечка данных
exfil-webhook-urlerrors.md:155URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла; в кавычках — упоминание, а не команда)f"https://api.telegram.org/bot{TOKEN}/{method}",vendor-hostв кавычках -
низкая Утечка данных
exfil-webhook-urlkeyboards.md:19URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \заглушка -
низкая Утечка данных
net-credential-usekeyboards.md:19Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \vendor-host -
низкая Утечка данных
exfil-webhook-urlkeyboards.md:85URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/answerCallbackQuery" \заглушка -
низкая Утечка данных
net-credential-usekeyboards.md:85Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/answerCallbackQuery" \vendor-host -
низкая Утечка данных
exfil-webhook-urlkeyboards.md:93URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/editMessageText" \заглушка -
низкая Утечка данных
net-credential-usekeyboards.md:93Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/editMessageText" \vendor-host -
низкая Утечка данных
exfil-webhook-urlkeyboards.md:114URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \заглушка -
низкая Утечка данных
net-credential-usekeyboards.md:114Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \vendor-host -
низкая Утечка данных
exfil-webhook-urlkeyboards.md:162URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \заглушка -
низкая Утечка данных
net-credential-usekeyboards.md:162Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \vendor-host -
низкая Утечка данных
exfil-webhook-urlmedia.md:25URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \заглушка -
низкая Утечка данных
net-credential-usemedia.md:25Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \vendor-host -
низкая Утечка данных
exfil-webhook-urlmedia.md:34URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \заглушка -
низкая Утечка данных
net-credential-usemedia.md:34Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \vendor-host -
низкая Утечка данных
exfil-webhook-urlmedia.md:48URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \заглушка -
низкая Утечка данных
net-credential-usemedia.md:48Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \vendor-host -
низкая Утечка данных
exfil-webhook-urlmedia.md:86URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl "https://api.telegram.org/bot${TOKEN}/getFile?file_id=…"заглушка -
низкая Утечка данных
net-credential-usemedia.md:86Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl "https://api.telegram.org/bot${TOKEN}/getFile?file_id=…"vendor-host -
низкая Утечка данных
net-credential-usemedia.md:105Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -O "https://api.telegram.org/file/bot${TOKEN}/photos/file_0.jpg"vendor-host -
низкая Утечка данных
exfil-webhook-urlmedia.md:118URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \заглушка -
низкая Утечка данных
exfil-webhook-urlmethods.md:9URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30"заглушка -
низкая Утечка данных
net-credential-usemethods.md:9Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30"vendor-host -
низкая Утечка данных
exfil-webhook-urlmethods.md:25URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \заглушка -
низкая Утечка данных
net-credential-usemethods.md:25Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \vendor-host -
низкая Утечка данных
exfil-webhook-urlmethods.md:44URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/deleteWebhook?drop_pending_updates=true"заглушка -
низкая Утечка данных
net-credential-usemethods.md:44Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/deleteWebhook?drop_pending_updates=true"vendor-host -
низкая Утечка данных
exfil-webhook-urlmethods.md:51URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl "https://api.telegram.org/bot${TOKEN}/getWebhookInfo"заглушка -
низкая Утечка данных
net-credential-usemethods.md:51Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl "https://api.telegram.org/bot${TOKEN}/getWebhookInfo"vendor-host -
низкая Утечка данных
exfil-webhook-urlmethods.md:62URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \заглушка -
низкая Утечка данных
net-credential-usemethods.md:62Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \vendor-host -
низкая Утечка данных
exfil-webhook-urlwebhooks.md:26URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)response=$(curl -s "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30")заглушка -
низкая Утечка данных
net-credential-usewebhooks.md:26Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)response=$(curl -s "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30")vendor-host -
низкая Утечка данных
exfil-webhook-urlwebhooks.md:47URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла; в кавычках — упоминание, а не команда)BASE_URL = f"https://api.telegram.org/bot{TOKEN}"vendor-hostв кавычках -
низкая Утечка данных
exfil-webhook-urlwebhooks.md:81URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl "https://api.telegram.org/bot${TOKEN}/getUpdates" \заглушка -
низкая Утечка данных
net-credential-usewebhooks.md:81Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl "https://api.telegram.org/bot${TOKEN}/getUpdates" \vendor-host -
низкая Утечка данных
exfil-webhook-urlwebhooks.md:114URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \заглушка -
низкая Утечка данных
net-credential-usewebhooks.md:114Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \vendor-host -
низкая Утечка данных
exfil-webhook-urlwebhooks.md:131URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \заглушка -
низкая Утечка данных
net-credential-usewebhooks.md:131Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \vendor-host -
низкая Утечка данных
net-credential-usewebhooks.md:139Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \vendor-host
Просканировано файлов: 9. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
name-formatname должен быть в kebab-case (строчные буквы, цифры, дефисы) - заметка
frontmatter-keyнеизвестное поле фронтматтера "slug" - заметка
frontmatter-keyнеизвестное поле фронтматтера "homepage"
Процессный рейтинг: все десять параметров 58/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 30Повторный запуск. Изменяющих операций: 9, без проверки текущего состояния
- 40Согласованность. Имя во frontmatter (Telegram Bot API) не совпадает с папкой (telegram-bot-api)
- 100Инструменты и файлы. Внешние инструменты не нужны
- 100Шаги. Шагов: 26
- 100Ошибки и развилки. Развилок: 1, есть раздел про ошибки
- 100Стоимость исполнения. Тело инструкции 1221 токенов
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Разделов верхнего уровня: 11. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 93: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Структура: 18 заголовков
- +3Пошаговые инструкции: 26 пунктов
- +4Есть примеры (2 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 74.