Frontend ai skills

Skills:

• mcp-adocs
• caveman
• unit-testing
• styling
• style-guide
• architecture
• code-review
• git-code-review

Требования

Для коректной работы skills необходимо настроить Astral Frontend MCP (adoc).

CLI

Установка skills

Установите skills в корень вашего проекта через CLI:

npx @astral/ai-skills install
# или
pnpm dlx @astral/ai-skills install

CLI интерактивно спросит:

1. Агент — Claude, Cursor или Codex и другие
2. Skills — какие skills установить (список формируется автоматически из пакета)

Skills копируются в:

• Claude → .claude/skills/<skill-name>/
• Cursor → .cursor/skills/<skill-name>/
• Codex и другие → .agents/skills/<skill-name>/

При повторной установке extends.md не перезаписывается — ваши локальные правила сохраняются.

Обновление

# все установленные skills в проекте
npx @astral/ai-skills update

# или выборочно
npx @astral/ai-skills update unit-testing styling

Без аргументов обновляет все skills, которые уже установлены в проекте. С аргументами — только указанные.

Обновление выполняется во всех найденных директориях агентов (.claude, .cursor и/или .agents). В логах выводится список обновлённых skills.

extends.md при обновлении не трогается — локальные правила сохраняются.

Список доступных и установленных skills

npx @astral/ai-skills list

Проверка обновлений

npx @astral/ai-skills check-updates

Показывает, у каких установленных skills есть отличия от пакета (extends.md не учитывается).

Расширение skills

Изменять SKILL.md нельзя потому что после обновления ваши правки будут удалены.

Для расширения skill локальными правилами создайте extends.md в директории skill:

unit-testing/
├── SKILL.md
├── extends.md

В каждом skill уже содержится информация о взаимодействии с extends.md.

Skills

Агент выбирает skill по полю description в SKILL.md. Skill с disable-model-invocation: true не подхватывается автоматически — только при явном вызове в промпте или через @skill-name.

MCP adocs

• Оптимизирует взаимодействие ИИ агента с adocs mcp.
• Описывает как взаимодействовать с tools.
• Рекомендует запускать анализ информации через subagents

Когда включается: автоматически перед любым вызовом MCP adocs (поиск в документации пакетов @astral/*, стандарты, UI-kit).

Caveman

Сокращает объем output токенов до 70% благодаря исключению из текста "воды". Адаптированная версия https://github.com/juliusbrussee/caveman: убрана лишняя информация связанная с китайским.

Когда включается: всегда, на каждый ответ агента. Отключение только явным запросом: «stop caveman» / «normal mode». Режимы: lite, full (default), ultra — через /caveman lite|full|ultra.

Unit testing

• Реализация тестов по guide
• Инкапуслированы документации для тестирования mobx-query и mobx-router (временно, пока не оптимизирован mcp)

Когда включается: автоматически при написании, рефакторинге или генерации unit-тестов в Vitest: тест-кейсы, suites, моки для функций, классов, компонентов, fetchers, router.

При тестировании хороший результат был получен на моделях:

• Composer 2.5
• Gemini 3.5 flash
• Haiku 4.5
• Более умные модели справляются без проблем (например, sonnet)

Настройка

Модифицируйте extends.md в зависимости от агента:

• Claude → .claude/skills/unit-testing/extends.md

• Cursor → .cursor/skills/unit-testing/extends.md

• Codex и другие → .agents/skills/unit-testing/extends.md

• Отредактируйте информацию о запуске тестов

• Добавьте свои локальные правила

Styling

• Правила стилизации через styled и компоненты ui-kit (Typography, Grid).
• Style guide

Когда включается: автоматически при работе со стилями, CSS и вёрсткой: styled-components, layout, темы, Typography, Grid, HTML-структура; при написании или изменении styles.ts.

Style guide

Содержит правила из style guides. Основыне правила в сжатом виде описаны в самом skill. Правила, которые нужны не всегда, подгружаются динамически из mcp adocs.

Когда включается: автоматически при работе с JS/TS/React: структура файлов, naming, организация кода. Не применяется к файлам styles.ts (для них — styling).

Architecture

• Описывает архитектуру. Агент понимает как писать код и куда его помещать (включая UIStore, DI...)
• Ограничения barrel files
• Узкие знания про legacy: repositories, external.ts
• Дает базовые знания о работе с mobx-query (fetchers)

Когда включается: автоматически при создании, анализе и рефакторинге кода; при вопросах о структуре проекта, слоях (app, screens, modules, api, shared), импортах, index-файлах, внешних libs и данных.

Code review

• Ручной code review указанных файлов по правилам architecture, style-guide, styling, unit-testing.

Когда включается: автоматически при запросе ревью конкретных файлов, фрагментов кода или списка файлов, которые пользователь явно указал. Агент подтягивает из перечисленных skills только те, что релевантны путям файлов.

Git code review

• Автоматический сбор изменений через git (unpushed, uncommitted, branch) и проведение code review по правилам из code-review.
• Режимы (default — незапушенные + незакоммиченные): unpushed, только незакоммиченные, diff относительно другой ветки (code review относительно master).

Когда включается: только явно — skill не подхватывается автоматически (disable-model-invocation). Триггеры: «review changes», «code review», «ревью незакоммиченных/незапушенных», «review branch», «code review относительно master» и аналоги.