(beta) Скиллы для AI-агентов
AI-агенты (Claude Code, Claude.ai и совместимые среды) смогут написать код для интеграции с T-API самостоятельно, если дать им знания о платформе. Для этого используйте наши скиллы.
Скиллы T-API — это готовые наборы инструкций (Agent Skills, открытый формат agentskills.io), которые превращают вашего AI-агента в специалиста по T-API: он знает актуальные методы и их скопы, развилку mTLS/ГОСТ, правила ретраев и чек-лист выхода в прод.
Оставить обратную связь по использованию скиллов
Список скиллов
| Скилл | Для чего | |
|---|---|---|
| Подключение с нуля до прода: выбор методов и скопов, выпуск токена, сертификаты, песочница, диагностика ошибок, вебхуки, go-live чек-лист. Включает машиночитаемый индекс всех методов T-API | |
| Счета, выписки, операции: актуальные методы, инкрементальная синхронизация, дедупликация, вебхук «Операция по счету», готовый скрипт выгрузки | |
| Партнерская интеграция (доступ к данным ваших клиентов): OAuth 2.0, client_id/secret, T-ID и T-Business ID, жизненный цикл токенов |
Скачать индекс скиллов для автоустановки
Исходники — на opensource.tbank.ru.
Установка
Каждый .skill-файл — это zip-архив, внутри которого лежит папка скилла
(например, t-api-integration/). Распаковка в каталог скиллов создает эту папку,
скиллы не перемешиваются между собой.
Claude Code
# для всех проектов пользователя
unzip t-api-integration.skill -d ~/.claude/skills/
unzip t-api-statements.skill -d ~/.claude/skills/
unzip t-api-partner-integration.skill -d ~/.claude/skills/
# или только для текущего проекта — то же самое в <проект>/.claude/skills/
Проверка: ls ~/.claude/skills/ — должны появиться три папки t-api-*, в каждой —
свой SKILL.md.
Claude.ai / Claude API
Загрузите .skill-файлы как есть в разделе Skills: Настройки → Возможности → Skills.
OpenAI Codex CLI
mkdir -p ~/.codex/skills
unzip t-api-integration.skill -d ~/.codex/skills/
unzip t-api-statements.skill -d ~/.codex/skills/
unzip t-api-partner-integration.skill -d ~/.codex/skills/
Cursor
Скиллы кладутся в проект:
mkdir -p .cursor/skills
unzip t-api-integration.skill -d .cursor/skills/
unzip t-api-statements.skill -d .cursor/skills/
unzip t-api-partner-integration.skill -d .cursor/skills/
Qwen Code
mkdir -p ~/.qwen/skills # для всех проектов (или .qwen/skills в проекте)
unzip t-api-integration.skill -d ~/.qwen/skills/
unzip t-api-statements.skill -d ~/.qwen/skills/
unzip t-api-partner-integration.skill -d ~/.qwen/skills/
# проверка: команда /skills внутри Qwen Code
Gemini CLI
mkdir -p ~/.gemini/skills # для всех проектов (или .gemini/skills в проекте)
unzip t-api-integration.skill -d ~/.gemini/skills/
unzip t-api-statements.skill -d ~/.gemini/skills/
unzip t-api-partner-integration.skill -d ~/.gemini/skills/
# проверка: /skills list внутри Gemini CLI
GitHub Copilot / VS Code
Скиллы проекта кладутся в .github/skills/ (персональные — ~/.config/github-copilot/skills/, на Windows — %APPDATA%\github-copilot\skills\). После установки перезапустите VS Code:
mkdir -p .github/skills
unzip t-api-integration.skill -d .github/skills/
unzip t-api-statements.skill -d .github/skills/
unzip t-api-partner-integration.skill -d .github/skills/
Другая среда со спецификацией agentskills.io
Многие среды (Codex, Cursor, Gemini CLI и другие) также читают кросс-агентный каталог .agents/skills/ в корне репозитория — это может быть удобно, когда команда работает в разных инструментах:
mkdir -p .agents/skills
unzip t-api-integration.skill -d .agents/skills/
# … и остальные два архива туда же
Полный список совместимых сред
Среда не поддерживает Agent Skills — промпты
Для ассистентов без поддержки скиллов у нас есть AI-промпты — по одному на задачу: подключение к T-API, выписки и операции, свод постоянных правил.
Кладутся как AGENTS.md в репозиторий или в кастомные инструкции ассистента.
Промпты — компромисс: в них нет скриптов, индекса методов и подгружаемых справочников, только ключевые правила и ссылки на документацию. При возможности используйте полноценные скиллы.
Как пользоваться скиллами
После установки сформулируйте задачу агенту — скилл подхватится автоматически:
- «Подключи нас к T-API: нужны выписки и платежи»
- «Какие скопы нужны токену для выставления счетов?»
- «Выгрузи операции по нашим счетам за прошлый месяц»
- «Почему T-API возвращает 403?»
- «Проверь интеграцию по go-live чек-листу перед продом»
Часть шагов нужно сделать вам (выпуск токена и сертификата в личном кабинете) — агент подготовит точную инструкцию и список доступов, которые нужно отметить.
Безопасность
- Скиллы не содержат секретов и не отправляют данные никуда, кроме доменов T-API.
- Агент получает токен только через переменную окружения и не выводит в чат и логи.
- Скрипты скиллов выполняют только проверки и чтение. Операции с деньгами агенту предписано выполнять только после явного подтверждения человеком.
- Запросы, выполненные скриптами скиллов, помечаются заголовком
User-Agent: T-API-Skill/...— это помогает поддержке быстрее разбирать обращения.
Обновления и обратная связь
Версия скилла указана в его SKILL.md (metadata.version). При расхождении скилла с документацией приоритет у документации. Анонсы обновлений публикуем в Telegram-канале T-Business API.