> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Навыки

Готовые инструкции, которые учат вашего кодового агента выполнять типовые задачи supastack так, как ожидает кит.

## Что такое навыки

supastack поставляется с Agent Skills: короткими инструкциями под задачу, которые кодовый агент загружает при совпадении работы. Вместо того чтобы каждый раз угадывать соглашения кита, агент следует одним и тем же шагам для функций, платежей, изменений базы данных и тестов. Навыки следуют открытому формату Agent Skills, поэтому работают в Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI и других совместимых агентах.


## Где лежат навыки

Навыки лежат в `.agents/skills/` — одна папка на навык с файлом `SKILL.md` внутри. Идентичные копии лежат в `.claude/skills/` для Claude Code.


## Какие агенты их читают

Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode читают `.agents/skills/`. Claude Code читает `.claude/skills/`. Агент выбирает навык автоматически, когда ваш запрос совпадает с его описанием, — или назовите его: «use the `database-schema-change` skill».


## Какие репозитории их поставляют

Репозиторий all-platforms включает все навыки. Репозитории web, mobile и desktop включают применимые к ним навыки; навыки сквозного тестирования и CI поставляются только с репозиторием all-platforms.


## Установка и окружение

Навыки для запуска, деплоя и настройки кита.

- **Настройка локального окружения** (`local-environment-setup`) — при развёртывании или починке локального окружения: первый клон, отсутствующий или сломанный .env, Postgres, миграции или порты.
- **Деплой и переменные окружения** (`deploy-and-env-vars`) — при деплое, выборе хостинга или добавлении/изменении переменной окружения.
- **Добавление зависимости** (`adding-a-dependency`) — при добавлении, обновлении, переносе или удалении npm-зависимости, либо когда CI не проходит проверку лицензий или аудит.
- **Обновление из upstream** (`upgrading-from-upstream`) — при переносе более свежего релиза supastack в продукт, построенный на нём.


## Создание функций

Навыки для добавления продуктовых поверхностей на каждой платформе.

- **Добавить веб-функцию** (`add-a-web-feature`) — для страницы или раздела продукта со своими данными, server actions, навигацией и тестами.
- **Добавить API-эндпоинт** (`add-an-api-endpoint`) — при добавлении или изменении публичного эндпоинта /api/v1, его документации OpenAPI или scope ключей API.
- **Добавить UI-компонент** (`add-a-ui-component`) — для секции, блока, элемента формы или переиспользуемого компонента по правилам стиля кита.
- **Изменить тему или стиль** (`change-the-theme-or-style`) — при изменении внешнего вида продукта: дизайн-стиль, цветовой пакет, плотность, радиус, шрифт или раскладка.
- **Добавить маркетинговую страницу или пост** (`add-a-marketing-page-or-blog-post`) — при добавлении или редактировании публичной страницы, страницы цен, юридической страницы, поста блога или гайда документации.
- **Добавить мобильный экран** (`add-a-mobile-screen`) — при добавлении или изменении экрана в мобильном приложении Expo.
- **Добавить возможность desktop** (`add-a-desktop-capability`) — при изменении desktop-приложения Tauri: окно, трей, глобальный хоткей или автообновления.
- **Добавить уведомление** (`add-a-notification`) — для in-app-уведомления, push-уведомления или пункта дайджеста.


## Авторизация и платежи

Навыки для входа, биллинга и планов.

- **Добавить метод авторизации** (`add-an-auth-method`) — при изменении входа: социальные провайдеры, magic-ссылки, коды по email, passkeys или двухфакторка.
- **Добавить платёжного провайдера** (`add-a-payment-provider`) — при включении провайдера биллинга или написании нового адаптера с checkout, клиентским порталом и вебхуками.
- **Изменить планы и цены** (`change-plans-and-pricing`) — при добавлении, переименовании или изменении цены плана: цены, триалы, места, entitlements, лимиты использования или кредиты.


## Данные и интеграции

Навыки для схемы, ИИ, задач, почты, хранилища и переводов.

- **Изменение схемы базы данных** (`database-schema-change`) — при добавлении или изменении таблицы, колонки, индекса или связи и генерации миграции.
- **Добавить ИИ-функцию** (`add-an-ai-feature`) — для вызова модели, инструмента чата или агента, долговременной ИИ-задачи, бюджетов или bring-your-own-key.
- **Добавить фоновую задачу** (`add-a-background-job`) — для работы, которая идёт после запроса, по таймеру или на workspace.
- **Добавить или изменить письмо** (`add-or-edit-an-email`) — при добавлении или изменении транзакционного письма или смене провайдера доставки.
- **Использовать файловое хранилище** (`use-file-storage`) — для загрузок и хранимых файлов: аватары, логотипы, вложения.
- **Добавить переводы** (`add-translations`) — при добавлении или изменении пользовательского текста, его переводе или добавлении локали.


## Качество и релиз

Навыки для тестов, проверки, ревью и CI.

- **Писать unit-тесты** (`writing-unit-tests`) — при написании или исправлении unit- и интеграционных тестов Vitest.
- **Писать e2e-тесты** (`writing-e2e-tests`) — при добавлении или исправлении end-to-end тестов Playwright, локально или в CI.
- **Проверить изменения** (`verify-changes`) — перед передачей, коммитом или pull request, чтобы выбрать и запустить нужные проверки.
- **Отладить упавший CI-прогон** (`debugging-a-failing-ci-run`) — когда прогон GitHub Actions падает и нужно найти и исправить причину.
- **Провести ревью PR** (`reviewing-a-pr`) — при ревью pull request или diff на корректность, изоляцию workspace и соглашения.


## Добавить свои

Создайте папку, имя которой совпадает с `name` в её frontmatter, с `name` и `description`, говорящим, когда её использовать. Скопируйте её и в `.claude/skills/`, чтобы каждый агент мог её найти.


## Вперёд

[Создавайте вместе с кодинг-агентом](https://supastack.dev/ru/docs/web/agents.md)