Навыки
Info
Навык — это инструкция для повторяющейся работы, которую агент подключает сам, когда задача ей соответствует. Правила, действующие всегда, живут в
AGENTS.md; процедуры, нужные иногда, — в навыках.
Как устроен навык
Навык — папка с файлом SKILL.md в открытом формате. В начале файла — блок метаданных, дальше — сама инструкция.
---
name: release-checklist
description: Подготовка релиза сервиса. Используй при подготовке релизной ветки, сборке образа и оформлении заметок о выпуске.
---
# Подготовка релиза
1. Проверь, что все задачи релиза закрыты.
2. Собери заметки о выпуске из коммитов между тегами.
...Оба поля обязательны. name — идентификатор навыка, description — условие его применения: агент читает описания всех доступных навыков и по ним решает, какой подключить к текущей задаче. Поэтому описание пишется как условие применения, а не как заголовок.
Плохое описание: Работа с релизами.
Хорошее описание: Подготовка релиза сервиса. Используй при подготовке релизной ветки, сборке образа и оформлении заметок о выпуске.
Размещение навыков в репозитории
Навыки лежат в папке .agents/skills, каждый в своей директории:
.agents/
skills/
release-checklist/
SKILL.md
api-contract-review/
SKILL.md
Имя навыка из поля name должно быть уникальным: если два навыка называются одинаково, применен будет только один из них, и какой именно — не определено.
Навыки подхватываются автоматически: отдельно включать их не нужно. Они действуют и в сессиях, и при работе GigaCode-разработчика, и в AI workflow-сценариях.
Рядом с SKILL.md можно положить вспомогательные файлы — скрипты, шаблоны, примеры — и ссылаться на них из инструкции. Агент прочитает их, когда они понадобятся.
Почему это экономит контекст
Агент не держит в памяти тексты всех навыков. Сначала он видит только имена и описания; полную инструкцию читает лишь тогда, когда навык подошел к задаче; вспомогательные файлы открывает уже по ходу работы.
Поэтому большой набор навыков не мешает работе, а длинный AGENTS.md — мешает: он попадает в контекст целиком и всегда.
Что выносить в навык
| Признак | Куда |
|---|---|
| Действует всегда и во всем репозитории | AGENTS.md |
| Нужно только в определенном типе задач | навык |
| Длиннее нескольких строк | навык |
| Содержит пошаговую процедуру | навык |
| Короткое правило или команда | AGENTS.md |
Типичные кандидаты: ревью по чек-листу команды, подготовка релиза, миграция базы данных, разбор инцидента, оформление документации, работа с конкретной внутренней библиотекой.
Общий набор навыков для нескольких репозиториев
Если один набор нужен нескольким проектам, храните его в отдельном репозитории и копируйте в рабочий репозиторий шагом workflow. Готовый пример — в разделе AI workflow-сценарии.
Как проверить навык
- Сформулируйте задачу так, как ее поставит реальный пользователь, — не упоминая навык.
- Убедитесь, что агент подключил нужный навык сам.
- Если не подключил — уточните
description: скорее всего, в нем не хватает формулировок, по которым задача узнается.
Что дальше
- Если процедуре нужна не только инструкция, но и отдельный набор прав и изолированный контекст, — сделайте своего агента.
- В GigaCode-ассистенте доступен набор готовых навыков платформы.