ztemerbekov/a1-yandex-kit-skills

Core guide to the Yandex KIT e-commerce API (kit.yandex.ru store builder): authentication, base URL, rate limits, error contract, pagination and offline spec search/validation scripts. Use when a task involves the Yandex KIT API and no domain skill (catalog, orders, promotions, store, webhooks) clearly fits, or when you need auth, limits or error-handling basics. Russian triggers include: «что умеет API Яндекс КИТ», «найди операцию в API», «какой лимит запросов», «почему ошибка LIMIT_EXCEEDED», «как авторизоваться в Ките».

Manage the Yandex KIT store catalog over its REST API: products, variants (SKUs, prices, stocks), bulk price/stock sync, variant documents (attachments), categories, characteristics (including groups and colors), product videos, collections, context collections and badges. Use when creating, updating, archiving or querying catalog entities in a Yandex KIT store, or when exporting storefront links of products to a CMS, PIM or feed. Russian triggers include: «заведи товар», «обнови цены», «загрузи остатки», «поменяй категорию», «добавь видео к товару», «синхронизируй каталог», «дай ссылку на товар», «выгрузи ссылки на товары».

Audit and exactly repair a Yandex KIT catalog. Use for Russian requests such as «Проверь каталог», «Проведи глубокий аудит», «Проверь группировку, карточки, медиа или коллекции», «Поставь цену 4 990 для SKU-42», «Исправь остатки по этому файлу» and exact single or bulk catalog fixes. Audits are read-only; writes require an explicit command with an exact target, operation and owner value or named authoritative source. Use a1-yandex-kit-operator instead for a fast current store signal.

Use for a Yandex KIT store launch-readiness review: «Можно запускать?», «Проверь готовность», «Что мешает открытию?», «Можно вести покупателей?». Model-invoked; the default workflow is fully read-only and distinguishes proven blockers, risks and unverified checkout links.

Use for an operational review or an exact owner-authorized change in a Yandex KIT store: «Как дела в магазине?», «Что срочного?», «Подтверди заказ 123», «Поставь цену 4 990 для SKU-42» or another command with an unambiguous target, action and value. Treat short «Как дела?» as a store request only when Yandex KIT context is already established.

Manage orders in a Yandex KIT store over its REST API: orders and their statuses, customers, gift cards, additional services (addons) and delivery documents (waybills, parcel labels). Use when listing, confirming or cancelling KIT orders, printing delivery labels, or when looking up customers, their orders or gift cards. Russian triggers include: «покажи заказы», «подтверди заказ», «отмени заказ», «что с заказом», «найди клиента», «выгрузи заказы за неделю», «распечатай ярлык».

Launch and manage Yandex KIT promotions. Use when the user asks «Запусти скидку», «Создай промокод» or «Добавь подарок»; wants to inspect promotions («Покажи акции»); or change dates, conditions, bindings or status («Продли акцию», «Останови промо»).

Manage promotions in a Yandex KIT store over its REST API: discounts, promo codes, promocode groups (shared codes and single-use coupon batches) and gifts. Use when creating or updating discounts, promocodes, promocode groups or gifts, or when binding them to products, categories or collections. Russian triggers include: «создай скидку», «сделай промокод», «выпусти партию промокодов», «добавь подарок к товару», «останови акцию».

Connect a Yandex KIT store to the current AI client, or reconnect it by replacing its token. Use for natural-language setup requests, including Russian text or voice transcripts such as «Связь с магазином», «Подключим магазин», «Переподключим магазин», «Переустановим связь с магазином» and «Поменяем токен». Treat short «Связь с магазином» as an orientation request.

Manage Yandex KIT store-level resources over its REST API: store profile, warehouses, users, geo regions, file uploads, redirects, blog/news posts and system alerts. Use when reading store metadata, managing warehouses or redirects, uploading files, publishing news or triaging store alerts in a Yandex KIT store. Russian triggers include: «покажи склады», «создай склад», «загрузи файл», «опубликуй новость», «какие алерты у магазина», «настрой редирект».

Manage Yandex KIT webhooks over its REST API: subscribe HTTPS endpoints to order status, payment and delivery events and handle the one-time signing secret. Use when creating, updating, validating or deleting KIT webhooks, verifying incoming calls, diagnosing missing order-status callbacks or migrating receipt-status automations. Russian triggers include: «настрой вебхук», «подпишись на статусы заказов», «почему не приходят уведомления о заказах», «проверь вебхук».