Свои навыки для AI-агента — как научить нейросеть работать по твоим правилам
Как задать нейросети собственные процедуры, чек-листы и стиль ответа через Markdown-навыки — чтобы не повторять одни и те же инструкции в каждом чате. На примере десктоп-агента Дока.
Если ты пользуешься ассистентом каждый день, то замечал: одни и те же инструкции приходится повторять из чата в чат. «Отвечай кратко», «сначала блокеры, потом мелочи», «оформляй по такому шаблону». Это можно вынести один раз — в навык. Разберём, как.
Что такое навык
Навык — это короткая переиспользуемая инструкция для агента: чек-лист, рабочая процедура, правило стиля или предпочтительный формат ответа. Ты описываешь её один раз, и агент подхватывает её сам, когда задача похожа на ту, для которой навык нужен.
Важно, чем навык не является: он не заменяет твой запрос и не отменяет проверку фактов. Это способ не диктовать одно и то же каждый раз, а не автопилот вместо тебя.
Как это работает в Доке
Дока читает навыки из локальной папки ~/.doka/skills/ — каждый навык это
отдельный Markdown-файл. При каждом запросе Дока сравнивает его с описанием навыков
и подмешивает в работу только релевантные — те, что подходят под текущую задачу.
Всё остальное не мешается под ногами.
Навыки лежат обычными файлами на твоём компьютере. Никакого облака: и сами инструкции, и то, к чему они применяются, остаются у тебя на машине.
Как написать свой навык
Навык — это Markdown-файл с небольшим блоком настроек (YAML frontmatter) в начале
и телом-инструкцией. Пример файла ~/.doka/skills/moy-stil-revyu.md:
---
name: moy-stil-revyu
description: Применять мой чек-лист для ревью кода.
triggers:
- ревью кода
- проверь код
---
# Мой стиль ревью
1. Сначала блокеры, потом всё остальное.
2. Не придираться к стилю, если это не влияет на корректность.
3. В конце — короткий вывод: мёржить или нет.
Три поля обязательны:
- name — короткий идентификатор латиницей:
moy-stil-revyu. - description — одно предложение о том, когда применять навык. По нему Дока и решает, релевантен ли он запросу.
- triggers — список фраз, при которых навык нужно подхватывать чаще.
Тело после настроек — сама инструкция. Пиши компактно: что делать, в каком порядке и как проверить результат. Самое важное держи в начале — при подстановке в работу длинное тело навыка усекается.
Каким должен быть хороший навык
- Короткий: обычно 20–80 строк, одна повторяемая процедура.
- С явными триггерами и проверкой результата в конце.
- Без секретов, API-ключей и токенов — навык не место для чувствительных данных.
Плохой навык пытается заменить собой всё: пихает десяток несвязанных правил или хранит разовые заметки вроде номеров задач. Такой только мешает.
Итог
Навык — это способ один раз записать своё правило и больше его не повторять. Один Markdown-файл на процедуру, понятные триггеры — и дальше Дока сама достаёт нужный навык, когда задача под него подходит. Больше про настройку под себя — в документации и примерах по профессиям.