a1-yandex-kit-skills

# Скажите, что должно получиться в Яндекс KIT, — ассистент сделает и проверит

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

Просто опишите, какой результат нужен. Ассистент выполнит работу в вашем магазине и проверит, что получилось.

**Промокод FIRST500 — создан и проверен через API**

> **Вы:** Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках.
>
> **Ассистент:** Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.

**Все документы распознаны и прикреплены к товарам**

> **Вы:** Здесь семь PDF-файлов: инструкции, технические паспорта и сертификаты. Названия непонятные. Разбери, к каким товарам относится каждый документ, и прикрепи их.
>
> **Ассистент:** Разобрал содержимое документов, сопоставил их с товарами по моделям и SKU, дал понятные названия и прикрепил к нужным карточкам. Прикреплено 7 из 7 документов, нераспознанных файлов нет.

**Вы решаете, что изменить в магазине, — ассистент выполняет и проверяет.** Без прямой команды он ничего не меняет и не придумывает цены, остатки или условия.

[Подключить магазин](#быстрый-старт) · [Посмотреть, что ещё можно поручить](#что-уже-умеет-ассистент) · [Подписаться на Telegram-канал](https://t.me/a1_yandex_kit_skills)

---

# AI-ассистент для Яндекс KIT

<img src="./assets/images/a1-logo-warm.svg" alt="A1" width="22">&nbsp;**Yandex KIT Skills** <sup>β</sup> позволяет управлять магазином из привычного приложения (Claude, Cursor, Codex и других). Вы ставите задачи обычными словами, а ассистент проверяет текущее состояние магазина, находит то, что требует внимания, и выполняет команды.

- **Четыре готовых сценария.** Операционные риски и приоритеты, ошибки каталога, запуск акций и готовность магазина к открытию.
- **Голосом или текстом.** Формулируйте рабочие задачи естественным языком. Пишите или диктуйте, если приложение поддерживает голосовой ввод. При желании можно вызвать нужный навык напрямую.
- **Изменения только по команде.** Проверки ничего не меняют, а цены, остатки, сроки и другие бизнес-значения ассистент не придумывает.

## Что уже умеет ассистент

1. **Оператор** (`a1-yandex-kit-operator`) проводит операционный разбор магазина: находит всё, из-за чего можно потерять заказ, деньги или репутацию, расставляет риски по срочности и формирует точный план действий.
2. **Доктор каталога** (`a1-yandex-kit-catalog-doctor`) находит ошибки, из-за которых товары теряют видимость и продажи, и по команде владельца исправляет их.
3. **Запуск промо** (`a1-yandex-kit-promo-launcher`) превращает заданные условия в готовую акцию: создаёт, изменяет и запускает скидки, промокоды и подарки в магазине.
4. **Проверка запуска** (`a1-yandex-kit-launch-check`) определяет, готов ли магазин к открытию и приёму заказов: находит блокеры и перечисляет всё, что ещё нужно подтвердить.
5. **Специализированные навыки.** `a1-yandex-kit-orders`, `a1-yandex-kit-catalog`, `a1-yandex-kit-promotions`, `a1-yandex-kit-store` и `a1-yandex-kit-webhooks` — для отдельных задач по заказам, каталогу, акциям, ресурсам магазина и вебхукам.
6. <img src="./assets/images/binoculars.png" alt="Бинокль" width="30"> Не нашли нужного сценария? [Расскажите, какой задачи вам не хватает, и следите за новыми возможностями.](https://t.me/a1_yandex_kit_skills)

## Увидеть работу за минуту

> **Вы:** Давай подключим мой магазин.
>
> **Ассистент:** Для подключения нужен токен Яндекс KIT. Откройте в кабинете **Настройки → API**, скопируйте ключ и вставьте его сюда.
>
> **Вы:** [вставляет токен]
>
> **Ассистент:** Готово — Яндекс KIT подключён. Проверка прошла: вижу магазин «Название магазина».
>
> **Вы:** Чё, как дела?
>
> **Ассистент:** Проверил магазин. Сегодня пришли три заказа: два уже оплачены, один ждёт оплаты.
>
> **Вы:** Создай категорию «Есть на чем присесть» и добавь туда два кресла.
>
> **Ассистент:** Категория «Есть на чем присесть» создана. В неё добавлены «Кресло Urban Relax» и «Nordic Comfort Lounge Chair».
>
> **Вы:** Создай коллекцию «Я чувствую тебя» и перекинь туда всё, что связано с парфюмом.
>
> **Ассистент:** Создал активную коллекцию и добавил в неё три парфюма. Из прежних коллекций товары не удалял.
>
> **Вы:** Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках товаров.
>
> **Ассистент:** Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.
>
> **Вы:** Подними все цены на 20%.
>
> **Ассистент:** Цены всех 12 товаров повышены с 999 ₽ до 1 199 ₽. Базовые и итоговые цены обновлены и проверены.
>
> **Вы:** [прикладывает семь PDF-файлов]
>
> Здесь инструкции, технические паспорта и сертификаты. Названия файлов непонятные. Разбери, к каким товарам относится каждый документ, и прикрепи их, пожалуйста.
>
> **Ассистент:** Разобрал содержимое семи документов и сопоставил их с каталогом по названиям моделей и SKU:
>
> - «Кресло Urban Relax» — инструкция по сборке и технический паспорт;
> - «Nordic Comfort Lounge Chair» — инструкция по сборке и спецификация материалов;
> - «Black Force», «Pink Dream» и «Champion Spirit» — декларация соответствия для каждого парфюма.
>
> Все совпадения однозначные. Прикрепил 7 из 7 документов, дал им понятные названия и проверил список документов у каждого товара. Нераспознанных файлов нет.

---

## Содержание

- [Быстрый старт](#быстрый-старт)
- [Подробнее о сценариях](#подробнее-о-сценариях)
- [Как ассистент взаимодействует с магазином](#как-ассистент-взаимодействует-с-магазином)
- [Обратите внимание](#обратите-внимание)
- [MCP-сервер](#mcp-сервер-model-context-protocol)
- [Установка через маркетплейсы](#установка-через-маркетплейсы)
- [Обновление](#обновление)
- [Документация](#документация)
- [Помощь и обратная связь](#помощь-и-обратная-связь)

## Быстрый старт

1. Откройте терминал и установите пакет навыков:

   ```bash
   npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y
   ```

   Чтобы позже получить свежие обновления, выполните `npx skills update`.

2. **Явно вызовите** установщик навыком `a1-yandex-kit-setup`. В Codex вызов выглядит так:

   ```text
   $a1-yandex-kit-setup
   ```

   В другом приложении выберите навык с этим именем в списке команд.

3. Следуйте вопросам установщика. Он проверит окружение и токен, подключит магазин к выбранному приложению и выполнит первый вызов.

4. После сообщения об успешном подключении рабочие сценарии можно вызывать обычными фразами — голосом или текстом. Начните с простого вопроса:

   > Как дела в магазине?

Установщик работает с Claude Code, Claude Desktop, Cursor, OpenAI Codex и другими приложениями. Пакет также можно установить через [маркетплейс приложения](#установка-через-маркетплейсы). Если подключение не завершилось, откройте [подробную инструкцию](docs/INSTALLATION.md): там есть полный список платформ, ручная настройка и способы устранения ошибок.

## Подробнее о сценариях

<details open>
<summary><strong>Оператор — риски и приоритеты магазина</strong></summary>

<br>

**Оператор** (`a1-yandex-kit-operator`) помогает вовремя увидеть всё, из-за чего магазин может потерять заказ, деньги или репутацию, не обходя вручную разделы кабинета.

**Что на выходе:** приоритетный разбор заказов, быстрого состояния каталога, промо и вебхуков за выбранный период. Каждый пункт опирается на факты из магазина; недоступные данные остаются явным ограничением.

> **Попробуйте спросить:**
>
> «Как дела в магазине?» · «Что срочного?» · «Покажи заказы за сегодня и их статусы оплаты».

</details>

<details>
<summary><strong>Доктор каталога — ошибки, мешающие товарам продаваться</strong></summary>

<br>

**Доктор каталога** (`a1-yandex-kit-catalog-doctor`) помогает поддерживать корректные карточки, цены и остатки, не открывая вручную каждый товар.

**Что на выходе:** полный аудит выбранных областей с точным покрытием, найденными объектами и разделением на блокеры, риски и рекомендации. По отдельной точной команде навык исправляет одиночные или массовые значения из указанного пользователем источника.

> **Попробуйте спросить:**
>
> «Проведи полный аудит каталога» · «Установи остаток у кроп-топа Summer Breeze: 13 штук» · «Исправь остатки по этому файлу».

</details>

<details>
<summary><strong>Запуск промо — акции по заданным условиям</strong></summary>

<br>

**Запуск промо** (`a1-yandex-kit-promo-launcher`) помогает запустить скидку, промокод или подарок точно на нужные товары и срок, не потеряв заданные условия при настройке.

**Что на выходе:** проверенные товары и существующие промо, выполнение разрешённой последовательности действий и повторное чтение итогового статуса. Механику, размер скидки, область действия, сроки, лимиты и статус задаёт пользователь; при нехватке условий запись не начинается.

> **Попробуйте спросить:**
>
> «Создай промокод SMPT10 “Сентябрь 10”: скидка 10% на все товары с 1 по 30 сентября 2026 года по Москве, без лимита использований. Активируй сразу».

</details>

<details>
<summary><strong>Проверка запуска — готовность магазина к открытию</strong></summary>

<br>

**Проверка запуска** (`a1-yandex-kit-launch-check`) помогает перед запуском убедиться, что покупатель сможет найти товар и пройти доступные этапы покупки без подтверждённых критических проблем.

**Что на выходе:** статус **«не готов»**, **«условно готов»** или **«готов»** с отдельными блокерами, рисками и непроверенными участками. Навык проверяет данные каталога и промо, подтверждения checkout, а при наличии web-доступа у приложения — публичную витрину. Ст