Навыки агента

Навык — это папка с инструкциями, которую агент подгружает, когда она становится нужна. У Astra есть свой, using-astra: агент, работающий в вашем проекте, будет знать, что компоненты копируются, а не импортируются, какие зависимости нужны каждому из них и что проверить, прежде чем писать код.

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

Установка

Навыки устанавливаются со страницы Навыки сайта Astra. Положите папку навыка в .claude/skills/ проекта, над которым работаете, или в ~/.claude/skills/, чтобы он был доступен во всех проектах.

Claude Code подхватит его на следующей сессии — без флага перезапуска и без записи в конфиге. Другие агенты, которые читают .claude/skills или принимают папку markdown, работают так же.

Что внутри

using-astra/
├── SKILL.md
└── references/
    ├── components.md
    ├── cli.md
    ├── mcp.md
    └── configuration.md

Заранее грузится только SKILL.md. Справочники читаются, когда задача их потребует, так что каталог ничего не стоит, пока компонент реально не выбирают.

Каталог генерируется

references/components.md не пишется руками, а выводится: имена и категории — из реестра, описания — с этих страниц документации, список зависимостей — из импортов в исходнике каждого компонента. Поэтому список зависимостей, который читает агент, — это то, что код действительно импортирует, а не список, разошедшийся с реальностью.

Без навыка

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

I'm using Astra in an Expo app.

- Components are copied into src/shared/components, not imported from a package.
  There is no `import { Accordion } from "astra-rn"`.
- Animations use react-native-reanimated; several components also need
  react-native-worklets, which installs separately.
- Read the Astra docs (/docs) before writing code.

Что проверять в сгенерированном коде

• Выдуманные импорты пакетов. Самая частая поломка с большим отрывом.
• Отсутствующий Babel-плагин Reanimated — агенты редко открывают babel.config.js. См. Установку.
• Skia в Expo Go — нужна сборка для разработки.
• Отсутствующий GestureHandlerRootView: с ним компоненты на жестах молча ничего не делают. См. Если что-то сломалось.