Навыки

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

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/, чтобы каждый агент мог её найти.