ИИ-агенты отлично пишут код. Но когда просишь задеплоить на Яндекс Облако или собрать отчёт из Метрики — результат непредсказуем. Агент может сходить в документацию, но в тысячах страниц Яндекс Облака он потратит контекст на поиск нужной команды, а подводные камни всё равно не найдёт — их там нет.
Мы собрали 6 скиллов, которые решают эту проблему. Всё в open source.
Что такое скилл для ИИ-агента
Скилл — это структурированная документация, которую агент получает в контекст в нужный момент. Не промпт, не плагин с кодом — именно документация: API endpoints, примеры команд, подводные камни.
Говоришь "задеплой сайт на Яндекс Облако" — агент подтягивает скилл yandex-cloud и знает, как создать бакет, загрузить файлы, настроить DNS. Без скилла он будет тратить токены на чтение документации или галлюцинировать команды.
Формат совместим с Claude Code, OpenClaw и любым агентом, который умеет читать markdown.
Что внутри
| Скилл | Что делает | Пример использования |
|---|---|---|
| yandex-cloud | Инфраструктура через yc CLI | "Задеплой сайт на Object Storage" |
| yandex-metrika | Аналитика через Reporting API | "Покажи трафик за неделю по городам" |
| yandexgpt | Yandex Foundation Models | "Сгенерируй текст через YandexGPT" |
| gigachat | GigaChat через gpt2giga прокси | "Переведи запрос в формат GigaChat" |
| yax | Яндекс 360: Диск, Календарь, Почта | "Создай встречу в Телемосте" |
| marketplace-ru | Ozon, WB, Яндекс Маркет | "Проверь новые заказы на Wildberries" |
Каждый скилл — 300-400 строк. В сумме — 1500+ строк документации, собранной из реальной работы. Разберём каждый подробнее.
Яндекс Облако: инфраструктура через CLI
Скилл покрывает Object Storage, Compute, Serverless Functions, DNS, сертификаты и все основные сервисы Яндекс Облака. Агент получает готовые команды yc для типичных задач.
Пример: говоришь "задеплой статический сайт" — агент создаёт бакет, загружает файлы с правильными MIME-типами, включает хостинг, настраивает публичный доступ и DNS. Без скилла — каждый из этих шагов требует отдельного чтения документации.
Подводный камень: Object Storage не определяет MIME-типы автоматически. Загружаете CSS — он отдаётся как application/octet-stream, и вёрстка ломается. Скилл содержит команды с явным указанием --content-type.
Яндекс Метрика: аналитика через API
Три API в одном скилле: Management (счётчики, цели), Reporting (отчёты, метрики, dimensions) и Logs (сырые данные). Полный справочник метрик и dimensions с примерами curl-запросов.
Пример: "покажи трафик за последнюю неделю по городам" — агент формирует запрос к Reporting API с нужными metrics, dimensions, date1/date2, парсит JSON и выдаёт таблицу. Плюс настройка счётчика в Next.js — компонент для SPA с отслеживанием переходов.
Подводный камень: данные в отчётах могут семплироваться. Параметр accuracy=full отключает семплирование, но замедляет запрос. Скилл указывает когда какой режим использовать.
YandexGPT: генерация текста
Авторизация через IAM-токены, маппинг моделей, формат запросов — всё, что отличает YandexGPT API от привычного OpenAI.
Пример: "сгенерируй описание товара через YandexGPT" — агент знает правильный endpoint, формат completionOptions, и как передать x-folder-id и IAM-токен.
Подводные камни:
- IAM-разрешения — это не роли.
ai.editorнужно вешать на folder через Access Binding, не на сервис-аккаунт. Ошибка — 403 без объяснения. x-folder-idобязателен в каждом запросе. В OpenAI API такого нет, и после него легко забыть.- Модели именуются иначе —
yandexgpt,yandexgpt-lite,yandexgpt-32k. Маппинг наgpt-4/claude-sonnetнужно делать вручную.
GigaChat: интеграция через прокси
GigaChat API полностью несовместим с OpenAI. Скилл описывает интеграцию через gpt2giga прокси, который транслирует запросы в формат OpenAI SDK — можно использовать привычный openai пакет для Python/Node.js.
Пример: "подключи GigaChat к проекту" — агент настраивает gpt2giga, прописывает credentials и адаптирует код, написанный под OpenAI.
Подводный камень: SSL-верификация может падать в некоторых окружениях. Скилл содержит workaround для этого.
Яндекс 360: Диск, Календарь, Почта, Телемост
OAuth-авторизация, работа с Диском через REST API, CalDAV для календаря, IMAP для почты. Каждый сервис в Яндекс 360 использует свой протокол — скилл собирает всё в одном месте.
Пример: "создай встречу в Телемосте на завтра в 15:00" — агент идёт через CalDAV API с правильными путями (/calendars/{login}@yandex.ru/events-{id}/).
Подводный камень: CalDAV-пути содержат email пользователя, и его нужно сначала получить через login.yandex.ru/info. Если пишете на /calendars/events/ — получите 404 без внятной ошибки.
Маркетплейсы: Ozon, Wildberries, Яндекс Маркет
Управление заказами, ценами и остатками на трёх маркетплейсах через CLI-инструменты. Единый интерфейс: --platform ozon|wb|ymarket переключает площадку.
Пример: "проверь новые заказы на всех площадках" — агент запускает mp-orders list для каждой платформы и собирает сводку.
| Ozon | Wildberries | Яндекс Маркет | |
|---|---|---|---|
| Формат цен | Рубли (строка) | Копейки (число) | Рубли (число) |
| Код валюты | RUB | RUB | RUR (не RUB!) |
| Rate limit | HTTP 429 | HTTP 429 + 409 | HTTP 420 |
Подводные камни:
- WB хранит цены в копейках.
504600— это 5046₽, не полмиллиона. Забыли конвертировать — товар улетит за 25₽. - Яндекс Маркет использует HTTP 420 (не 429!) для rate limit. Стандартные retry-библиотеки не ловят этот код.
- WB код 409 считается за 10 запросов к лимиту. Один 409 — и вы уже на 10% ближе к блокировке.
Как установить
git clone https://github.com/smvlx/awesome-ru-ai-skills.git ~/awesome-ru-ai-skills
~/awesome-ru-ai-skills/install.shИли один конкретный скилл:
cp -r skills/yandex-cloud ~/.claude/skills/Репозиторий открыт — можно использовать, можно добавлять свои скиллы. Есть слоты под Bitrix24, amoCRM, 1С.