Каталог, скилл и бот

Проект помогает находить реальные Telegram custom_emoji_id, выбирать подходящие
символы для интерфейса и сохранять выбор при развитии приложения.

Windows · macOS · Linux — один пакет. Для Codex, Claude Code, Cursor,
GitHub Copilot, OpenCode и других агентов с поддержкой
Agent Skills.

Установить за минуту

Для скилла нужны Git и Python 3.11+. Дополнительные Python-пакеты, токен бота
и ключ модели для подбора не требуются.

git clone https://github.com/Zulut30/premium-telegram-emoji.git
cd premium-telegram-emoji
python3 install_skill.py --agent codex

На Windows / PowerShell последняя команда:

py -3 install_skill.py --agent codex

Выбери своего агента:

Используй доступный интерпретатор: python3, python или py -3.
Установщик напечатает точный путь. Открой новую сессию агента.
Для установки в приложение добавь --scope project --project "/path/to/app".

Без Git: скачай ZIP из релиза,
распакуй и запусти находящийся внутри install_skill.py.

Полное руководство → — пути для всех агентов, Windows,
проектная установка, ручной импорт, обновление и установка других скиллов.

Просто попроси агента

Используй telegram-premium-emoji. Подбери эмодзи для настроек, поиска,
уведомлений и оплаты. Нужен единый минималистичный стиль.
Проверь превью, сохрани выбор в emoji-style.json приложения и примени в коде.

В Codex можно написать $telegram-premium-emoji, в Claude Code —
/telegram-premium-emoji, в Cursor — выбрать скилл из меню /.

Следующие задачи продолжают тот же стиль:

Добавь экран подписки. Используй существующий emoji-style.json:
сохрани выбранный пак и уже закреплённые ID, подбери недостающие роли.

Агент читает профиль приложения, уточняет назначение каждого символа и получает
короткий список кандидатов. Затем проверяет реальные изображения и сохраняет
точные ID. Обновление каталога не заменяет принятые решения.

Что делает подбор надёжнее

• Действие и предмет: «удалить файл» ищет удаление; файл служит контекстом.
• Разные состояния: включённые и отключённые уведомления получают разные роли.
• Ограничения: статичность, одноцветность и возможность перекрашивания проверяются по метаданным.
• Проверенный выбор: --bind ROLE=ID закрепляет конкретный вариант после просмотра превью.
• Стабильный стиль: один основной пак; дополнительные источники записываются осознанно.
• Честные пробелы: слабое совпадение по категории или неизвестное изображение не заполняет роль автоматически.
• Составные эмодзи: рамки, кнопки и надписи сохраняют порядок частей и повторяющиеся ID.

Скилл переносим между агентами: профиль хранится в приложении и содержит
роли, паки, ограничения и строковые ID. Подбор использует правила и проверенные
метаданные; агент интерпретирует задачу и оценивает превью. Полный процесс требует
доступа к файлам и Python; просмотр изображений — доступа к сети.

Руководство по подбору → · Инструкции скилла →

Команды ниже запускаются из папки скилла или репозитория. Для профиля укажи
абсолютный путь к приложению.

python3 scripts/select_emoji.py styles
python3 scripts/select_emoji.py search "колокольчик без звука" --style minimal
python3 scripts/select_emoji.py search "уведомления" --animation static --color monochrome
python3 scripts/select_emoji.py search "уведомления" --profile "/path/to/app/emoji-style.json"

python3 scripts/select_emoji.py palette --style minimal --pack sfsymbols --roles notifications_on notifications_muted --role-query "notifications_on=включить уведомления" --role-query "notifications_muted=колокольчик без звука" --profile "/path/to/app/emoji-style.json" --save
python3 scripts/select_emoji.py validate "/path/to/app/emoji-style.json"
python3 scripts/select_emoji.py compositions "ПОЛЕЗНОЕ" --pack nexus_base

В Telegram используй полученный HTML с parse_mode="HTML"; в веб-интерфейсе —
preview_url как изображение. Тег <tg-emoji> предназначен для сообщений Telegram.

Посмотреть каталог

Открыть онлайн-каталог →

Поиск по названию, смыслу, ключу и ID; фильтры по паку и стилю; реальные превью;
копирование ID и HTML; личные оценки. Выбранный стиль и пак сохраняются в браузере,
а профиль можно экспортировать для агента.

Пополнить каталог

Отправь боту сообщение вида [premium emoji] Описание на русском, затем выбери
раздел или создай новый. Бот извлечёт реальный ID, сохранит запись и отправит
изменения в GitHub. Actions соберёт и опубликует сайт.

Скилл работает независимо от бота. Инструкции по запуску, импорту новых паков и
проверкам проекта находятся в руководстве разработчика.

Как устроен проект

SKILL.md + scripts/select_emoji.py → кандидаты → просмотр превью → emoji-style.json
                                  ↳ точные ID и роли в коде приложения

Telegram → bot.py → каталог и метаданные → GitHub Actions → GitHub Pages
                                        ↳ переносимый ZIP / .skill

SKILL.md                 Инструкции для агента
install_skill.py         Установка и обновление на трёх ОС
scripts/select_emoji.py  Переносимая точка входа
emoji_catalog.py         Чтение каталога без конфигурации бота
emoji_selection.py       Поиск, ограничения и профили
references/             Каталог и руководства
data/                   Проверенные метаданные и политика подбора
web/                     Исходники сайта
bot.py                   Пополнение через Telegram
.github/workflows/       Публикация сайта и проверка/сборка скилла

CI проверяет установку и подбор на Windows, macOS и Linux. ZIP и .skill
собираются из явного списка файлов, с проверкой SHA-256; токены, логи и рабочее
окружение в пакет не входят. Проверки: GitHub Actions.

Добавить свои эмодзи

Используй бота или предложи PR с каталогом и проверенными метаданными.
Для целого пака сначала просмотри изображения и подпиши их; затем выполни импорт.
Процесс импорта и проверки →