SKILLEMALL.ai

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.

modbender/skill-library-mcp Agent Skills автор: modbender MIT 9 файлов тело ≈ 1 221 токенов Открыть источникgithub.com↗ проанализирован 5 дн назад

Создание ботов Telegram с правильными вызовами API, форматированием сообщений, клавиатурами и настройкой вебхуков.

Как процесс C 58/100 · Есть пробелы — слабые места: результат и критерий готовности, когда включается, входы и предусловия

ИнтеграцияTelegramРазработкаДизайнМедиа и видеотип и темы размечены автоматически по тексту скилла
JSON
Технический рейтинг
D
58/100
безопасность, качество, тесты
Безопасность 60%
48
Качество 40%
74
Прогон на моделях
не было
Процессный рейтинг
C
58/100
Есть пробелы
Результат и критерий готовности вес 14
0
Входы и предусловия вес 11
0
Когда включается вес 12
20
три самых слабых из десяти параметров · все десять

Чем это грозит

Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.

Утечка данных средняя серьёзность

Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.

Если установить

Инструкции или скрипты отправляют данные наружу: переменные окружения, ключи, содержимое файлов, историю чата. Вы можете не заметить этого в диалоге, потому что агент выполнит отправку как «часть задачи».

Автору

Если отправка не нужна для задачи, уберите её: каталоги помечают такие скиллы как подозрительные и снимают с выдачи. Если нужна, назовите адрес явно, объясните, что именно уходит, и дайте пользователю выключатель.

Как улучшить

    Для прогона на моделях — необязательно
    • Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
    • spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.

    Находки guard · 44

    ✓ Критических и высоких находок нет

    Средние и низкие: 44
    • средняя Утечка данных exfil-webhook-url SKILL.md:48
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла)
      https://api.telegram.org/bot{TOKEN}/{METHOD}
      vendor-host
    • средняя Утечка данных exfil-webhook-url SKILL.md:131
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла)
      | https://api.telegram.org/bot{TOKEN}/* | Messages, media, commands | All bot operations |
      vendor-host
    • низкая Утечка данных exfil-webhook-url errors.md:88
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла; в кавычках — упоминание, а не команда)
      url = f"https://api.telegram.org/bot{TOKEN}/sendMessage"
      vendor-hostв кавычках
    • низкая Утечка данных exfil-webhook-url errors.md:155
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла; в кавычках — упоминание, а не команда)
      f"https://api.telegram.org/bot{TOKEN}/{method}",
      vendor-hostв кавычках
    • низкая Утечка данных exfil-webhook-url keyboards.md:19
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      заглушка
    • низкая Утечка данных net-credential-use keyboards.md:19
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url keyboards.md:85
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/answerCallbackQuery" \
      заглушка
    • низкая Утечка данных net-credential-use keyboards.md:85
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/answerCallbackQuery" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url keyboards.md:93
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/editMessageText" \
      заглушка
    • низкая Утечка данных net-credential-use keyboards.md:93
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/editMessageText" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url keyboards.md:114
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      заглушка
    • низкая Утечка данных net-credential-use keyboards.md:114
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url keyboards.md:162
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      заглушка
    • низкая Утечка данных net-credential-use keyboards.md:162
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url media.md:25
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \
      заглушка
    • низкая Утечка данных net-credential-use media.md:25
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url media.md:34
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \
      заглушка
    • низкая Утечка данных net-credential-use media.md:34
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url media.md:48
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \
      заглушка
    • низкая Утечка данных net-credential-use media.md:48
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url media.md:86
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl "https://api.telegram.org/bot${TOKEN}/getFile?file_id=…"
      заглушка
    • низкая Утечка данных net-credential-use media.md:86
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl "https://api.telegram.org/bot${TOKEN}/getFile?file_id=…"
      vendor-host
    • низкая Утечка данных net-credential-use media.md:105
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -O "https://api.telegram.org/file/bot${TOKEN}/photos/file_0.jpg"
      vendor-host
    • низкая Утечка данных exfil-webhook-url media.md:118
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendPhoto" \
      заглушка
    • низкая Утечка данных exfil-webhook-url methods.md:9
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30"
      заглушка
    • низкая Утечка данных net-credential-use methods.md:9
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30"
      vendor-host
    • низкая Утечка данных exfil-webhook-url methods.md:25
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \
      заглушка
    • низкая Утечка данных net-credential-use methods.md:25
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url methods.md:44
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/deleteWebhook?drop_pending_updates=true"
      заглушка
    • низкая Утечка данных net-credential-use methods.md:44
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/deleteWebhook?drop_pending_updates=true"
      vendor-host
    • низкая Утечка данных exfil-webhook-url methods.md:51
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl "https://api.telegram.org/bot${TOKEN}/getWebhookInfo"
      заглушка
    • низкая Утечка данных net-credential-use methods.md:51
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl "https://api.telegram.org/bot${TOKEN}/getWebhookInfo"
      vendor-host
    • низкая Утечка данных exfil-webhook-url methods.md:62
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      заглушка
    • низкая Утечка данных net-credential-use methods.md:62
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url webhooks.md:26
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      response=$(curl -s "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30")
      заглушка
    • низкая Утечка данных net-credential-use webhooks.md:26
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      response=$(curl -s "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=…&timeout=30")
      vendor-host
    • низкая Утечка данных exfil-webhook-url webhooks.md:47
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (хост вендора самого скилла; в кавычках — упоминание, а не команда)
      BASE_URL = f"https://api.telegram.org/bot{TOKEN}"
      vendor-hostв кавычках
    • низкая Утечка данных exfil-webhook-url webhooks.md:81
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl "https://api.telegram.org/bot${TOKEN}/getUpdates" \
      заглушка
    • низкая Утечка данных net-credential-use webhooks.md:81
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl "https://api.telegram.org/bot${TOKEN}/getUpdates" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url webhooks.md:114
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \
      заглушка
    • низкая Утечка данных net-credential-use webhooks.md:114
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \
      vendor-host
    • низкая Утечка данных exfil-webhook-url webhooks.md:131
      URL вебхука / коллбэка, типичный для эксфильтрации (проверьте адрес) (значение-заглушка)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \
      заглушка
    • низкая Утечка данных net-credential-use webhooks.md:131
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \
      vendor-host
    • низкая Утечка данных net-credential-use webhooks.md:139
      Учётные данные используются в сетевом вызове (проверьте, что адрес — нужный сервис) (хост вендора самого скилла)
      curl -X POST "https://api.telegram.org/bot${TOKEN}/setWebhook" \
      vendor-host

    Просканировано файлов: 9. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.

    По спецификации Agent Skills

    • предупреждение name-format name должен быть в 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.