Создать свой навык

Если то, что вы только что вместе с агентом сделали, наверняка понадобится ещё не раз — стоит превратить это в отдельный навык, а не повторять всё с нуля каждый следующий раз.

Из чего состоит навык

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

Где хранятся навыки

Все навыки агента лежат в одной папке (app/skills) — каждый навык в своей собственной подпапке, названной именем навыка.

Типичные файлы внутри папки навыка

• SKILL.md — единственный обязательный файл. Инструкция: что делает навык и когда его использовать.
• scripts/ (необязательно) — вспомогательные скрипты, которые навык запускает для выполнения задачи.
• references/ (необязательно) — дополнительные материалы, которые агент читает по мере необходимости, а не сразу целиком.
• assets/ (необязательно) — готовые шаблоны, изображения и другие файлы, которые использует навык.

Формат SKILL.md

Файл состоит из двух частей: короткого блока с описанием навыка (между строками ---) и обычного текста ниже — собственно инструкции.

---
name: имя-навыка
description: Когда и для чего использовать этот навык — по этому описанию
  агент понимает, что навык подходит для вашего запроса.
---

# Название навыка

Здесь текстом описывается, что именно должен делать агент при работе с этим
навыком: последовательность шагов, на что обращать внимание, какие есть
ограничения.

Когда стоит попросить создать навык

Хороший момент — сразу после того, как вы вместе с агентом прошли через что-то не самое тривиальное: несколько шагов, уточнений, доработок в долгом разговоре. Если чувствуете, что к этой задаче вы ещё вернётесь — попросите:

«Оформи то, что мы только что сделали, в отдельный навык, чтобы в следующий раз не объяснять всё заново»

Агент сам разберёт, что именно вы делали, оформит это как навык и в следующий раз применит его сразу, как только увидит похожий запрос.

После того как он его опишет - рекомендуется чтобы агент отправил его вам на отсмотр и правки. Чтобы Вы могли что-то обобщить или скорректировать и быть уверенным в следующих его исполнениях.

Что дальше

Технические детали устройства навыка — в разделе Как добавить новый навык.