Скилл для ИИ-агента

Набор правил и готовых команд, который агент читает перед тем, как обращаться к нашим данным. Ставится в проект одной папкой и работает с Claude Code, Cursor и любым агентом, умеющим читать файлы проекта.

Схемы OpenAPI агенту мало

Схема говорит, какие параметры принимает метод. Она не говорит, что RU-77 это Чукотка, а не Москва; что «промышленность в целом» лежит отдельным рядом, а не собирается сложением разделов; что делить индекс на индекс нельзя.

Эти ошибки тихие: запрос проходит, ответ приходит, цифры выглядят правдоподобно. Скилл и есть те знания, которых в схеме нет.

Что меняется

Вопрос один и тот же: «что происходило с промышленным производством в июле, лучше или хуже июня?»

Без скилла

агент не нашёл сводный ряд и написал, что «сводного индекса в наборе нет»;
собрал вывод сложением четырёх разделов - у Росстата так не считают;
смешал в одном рейтинге годовые, месячные и накопленные показатели;
посчитал изменение индекса в процентах от индекса: «+141%» там, где было плюс полтора пункта;
шестнадцать запусков скрипта, около четырёх минут.

Со скиллом

головной ряд найден сразу: «Собирательная группировка "Промышленность"»;
ответ от общего к частному: итог, затем разделы, затем виды деятельности;
снятые с наблюдения ряды отброшены до расчётов;
индексы сравниваются в пунктах, показатели между собой не смешиваются;
одна команда, меньше секунды.

Со скиллом типовой разбор - одна команда

python .claude/skills/rustata-api/rustata.py movers fedstat/indicator_57806 geo=643 measure=YOY

fedstat/indicator_57806 | территория 643 | периодов 4 (2026-04-01..2026-07-01)
рядов 128 | выросло 47, снизилось 80 | медиана -1.90 п.п.
набор: fresh
ВНИМАНИЕ: значения - индексы (уже проценты), изменения показаны в пунктах

Что внутри

Файл	Что в нём
`SKILL.md`	правила разбора: от общего к частному, что из чего можно пересчитать, где тихие ошибки в кодах территорий, почему ровная линия не всегда поломка
`reference.md`	справочник: параметры методов, поля ответа, колонки CSV, лимиты, коды ошибок
`rustata.py`	клиент на стандартной библиотеке: токен, страницы, ошибки, готовые сводки `movers` и `regions`

Поставить

Положите три файла в .claude/skills/rustata-api/ своего проекта и выдайте агенту токен через переменную окружения:

mkdir -p .claude/skills/rustata-api
cd .claude/skills/rustata-api
curl -O https://rustata.ru/api/agent/SKILL.md
curl -O https://rustata.ru/api/agent/reference.md
curl -O https://rustata.ru/api/agent/rustata.py

export RUSTATA_TOKEN=rst_ваш_токен

Токен берётся в личном кабинете и в код не попадает: клиент читает его из окружения. Дальше агенту достаточно сказать, что нужен разбор по нашим данным - правила он прочитает сам.

Скилл описывает наш API и ничего не знает о ваших данных. Он не отправляет никуда ничего, кроме запросов к rustata.ru/api/v1 с вашим токеном, и подчиняется тем же лимитам.