Скиллы
Скилл — сохраненный набор инструкций для агента. Например, как оформлять заметку о релизе или проверять статью по стайлгайду. Агент сам применяет подходящие скиллы, а чтобы он точно использовал конкретный, подключите его к чату вручную.
Скиллы каталога хранятся в самом каталоге, в папке .gramax/agent/skills, и попадают в репозиторий вместе с остальными изменениями.
Создать скилл
В панели агента нажмите + под полем ввода и выберите Скиллы → Управление скиллами.
Нажмите + → Новый скилл.
Заполните название и опишите, что агент должен делать.

Можно и просто попросить агента создать или изменить скилл в чате.
Скилл — это статья: заголовок — название скилла, текст — инструкция для агента.
Первый абзац — описание. В списке скиллов агент видит только его и по нему решает, брать ли скилл в работу. Напишите, что делает скилл, когда его использовать и когда нет. Описание — один абзац без пустых строк. Ниже — сама инструкция: шаги, правила, примеры.
Оформляет заметку о новой версии в разделе «Что нового». Используй, когда просят описать релиз. Не используй для правки обычных статей и для переводов. ## Шаги 1. Найди заметку о предыдущей версии и возьми ее за образец. 2. Сгруппируй изменения: новые возможности, улучшения, исправления. ## Правила - Пиши о том, что изменилось для пользователя, а не о том, как это сделано.
Запускать команды и скрипты агент не умеет. Скилл может опираться только на его инструменты.
Подключить к чату
Нажмите + под полем ввода и выберите Скиллы.
Выберите скилл — он появится меткой рядом с +. Нажмите на метку, чтобы открыть скилл, или на крестик, чтобы отключить.
В пространстве Gramax Enterprise Server список скиллов разделен на группы: Каталог — скиллы текущего каталога, Пространство — общие скиллы для всех каталогов. Поиск ищет сразу в обеих группах.

Чтобы изменить скилл, в том же списке выберите Редактировать скилл.
Агент видит только список скиллов — название и описание каждого. Когда задача подходит под описание, он открывает скилл и читает его целиком. Подключенный вручную скилл агент получает сразу и выполняет как обязательную инструкцию.
Встроенные скиллы
Кроме скиллов каталога у агента есть встроенные. Изменить или удалить их нельзя.
Диаграммы — создание и правка диаграмм Mermaid.
Скиллы — создание и правка скиллов каталога по просьбе в чате.
Планирование — сложные задачи: агент сначала изучает материал и составляет план, потом вносит правки.
Календарь — работа с календарем по CalDAV, например с Яндекс Календарем или iCloud. Нужна запись
Calendarс типом Логин в разделе Ключи и пароли: логин — адрес почты, пароль — пароль приложения, URL — адрес CalDAV-сервера, напримерhttps://caldav.yandex.ru.Почта — чтение и отправка писем по IMAP и SMTP. Только в десктопном приложении. Нужна запись
Mailс типом Логин в разделе Ключи и пароли: логин — адрес почты, пароль — пароль приложения, URL — почтовый домен, напримерyandex.ru.
Свой системный промпт
Системный промпт — общие инструкции, по которым агент работает в каталоге: тон, терминология, порядок работы. Чтобы задать свои, создайте в каталоге файл .gramax/agent/system-prompt.md и напишите инструкции в нем.
Файл заменяет стандартные инструкции целиком, а не дополняет их. Список скиллов и названия ключей и паролей агент получает в любом случае. Если файл пустой, агент работает со стандартными инструкциями.