За последний месяц я создала для своей команды довольно много скиллов. Делюсь, что поняла методом проб и ошибок.
Формальные требования, структуру файлов и другие душные инструкции можно посмотреть в официальной документации Agent Skills. Там всё серьёзно и по правилам. Здесь — то, что я выяснила на практике.
Создавайте скилл только для повторяющихся задач. Если её предстоит решить один раз, проще написать хороший промпт и получить результат. Скилл имеет смысл, когда вы регулярно выполняете один и тот же процесс и каждый раз заново объясняете агенту, что и как делать.
Description — это не инструкция, а табличка на двери. Сначала агент видит только название и description. По ним он понимает, подходит ли скилл к задаче. Если подходит, загружает полную инструкцию из SKILL.md.
Поэтому в description не нужно пытаться уместить весь порядок работы. Его задача — коротко объяснить, что делает скилл, когда его использовать и по каким словам агент сможет его узнать.
Основную инструкцию пишите как для джуна, который вчера пришёл в команду. Когда скилл подключился, агент загружает основную часть SKILL.md. Вот здесь уже нужно объяснить, как выполнять задачу максимально подробно.
Новичок, который присоединился к вашей команде вчера, пока не умеет читать ваши мысли 😅 не знает сленг и стандартные процессы. Расскажите ему, каким источникам доверять, где лежат определения, какие фильтры обязательны, что нельзя сравнивать, в каком порядке действовать и какой результат вы от него ждёте.
Можно добавить пошаговый процесс, примеры входа и результата, а также пограничные случаи. Если материалов становится слишком много, подробности лучше вынести в отдельные справочные файлы.
Скиллы бывают очень разными по сложности. Какой-то скилл можно сделать за пару часов — например, если нужно что-то обновить или добавить по понятным правилам. Но недавно ребята рассказывали, как втроём потратили около 40 часов на создание одного скилла, поэтому я бы не говорила, что писать скиллы — это однозначно легко или сложно. Всё зависит от задачи.
Если нужно автоматизировать простое действие, скилл получится небольшим. А если вы хотите научить агента делать факторный анализ, это уже сложная задача даже для сеньор-аналитика. Значит, и скилл будет сложным: в него нужно перенести не только шаги, но и логику анализа.
Хороший скилл редко получается с первого раза. Создание скилла — итерационный процесс. Нейронки могут глючить, выдумывать, додумывать и делать всё это с очень уверенным видом 🥸
Поэтому сначала обкатайте скилл на себе, потом отдайте коллегам-аналитикам, а затем — кому-то из заказчиков.
Люди могут пользоваться скиллом совсем не так, как вы представляли, пока его писали. Поэтому рабочая версия обычно появляется после нескольких итераций и разбора реальных кейсов применения.
Хороший скилл не заменяет аналитика. Он упаковывает повторяющуюся часть работы: контекст, порядок действий, ограничения и проверки, которые иначе приходится объяснять заново в каждом запросе.
P. S. А ещё у нас в компании есть скилл, который помогает создавать скиллы. Да, вот такая рекурсия)
Формальные требования, структуру файлов и другие душные инструкции можно посмотреть в официальной документации Agent Skills. Там всё серьёзно и по правилам. Здесь — то, что я выяснила на практике.
Создавайте скилл только для повторяющихся задач. Если её предстоит решить один раз, проще написать хороший промпт и получить результат. Скилл имеет смысл, когда вы регулярно выполняете один и тот же процесс и каждый раз заново объясняете агенту, что и как делать.
Description — это не инструкция, а табличка на двери. Сначала агент видит только название и description. По ним он понимает, подходит ли скилл к задаче. Если подходит, загружает полную инструкцию из SKILL.md.
Поэтому в description не нужно пытаться уместить весь порядок работы. Его задача — коротко объяснить, что делает скилл, когда его использовать и по каким словам агент сможет его узнать.
Если совсем просто, description отвечает на вопрос: «Когда подключать этот скилл?»
Основную инструкцию пишите как для джуна, который вчера пришёл в команду. Когда скилл подключился, агент загружает основную часть SKILL.md. Вот здесь уже нужно объяснить, как выполнять задачу максимально подробно.
Новичок, который присоединился к вашей команде вчера, пока не умеет читать ваши мысли 😅 не знает сленг и стандартные процессы. Расскажите ему, каким источникам доверять, где лежат определения, какие фильтры обязательны, что нельзя сравнивать, в каком порядке действовать и какой результат вы от него ждёте.
Можно добавить пошаговый процесс, примеры входа и результата, а также пограничные случаи. Если материалов становится слишком много, подробности лучше вынести в отдельные справочные файлы.
То есть основная инструкция отвечает уже на другой вопрос: «Как именно выполнить эту задачу?»
Скиллы бывают очень разными по сложности. Какой-то скилл можно сделать за пару часов — например, если нужно что-то обновить или добавить по понятным правилам. Но недавно ребята рассказывали, как втроём потратили около 40 часов на создание одного скилла, поэтому я бы не говорила, что писать скиллы — это однозначно легко или сложно. Всё зависит от задачи.
Если нужно автоматизировать простое действие, скилл получится небольшим. А если вы хотите научить агента делать факторный анализ, это уже сложная задача даже для сеньор-аналитика. Значит, и скилл будет сложным: в него нужно перенести не только шаги, но и логику анализа.
Хороший скилл редко получается с первого раза. Создание скилла — итерационный процесс. Нейронки могут глючить, выдумывать, додумывать и делать всё это с очень уверенным видом 🥸
Поэтому сначала обкатайте скилл на себе, потом отдайте коллегам-аналитикам, а затем — кому-то из заказчиков.
И сразу просите присылать трейсы: по ним проще понять, на каком шаге скилл пошёл не туда и что именно нужно исправить. Тут всё как в разработке: у разработчика всё работает, а потом он отдаёт продукт тестировщику — и у тестировщика не работает ничего 🗿
Люди могут пользоваться скиллом совсем не так, как вы представляли, пока его писали. Поэтому рабочая версия обычно появляется после нескольких итераций и разбора реальных кейсов применения.
Хороший скилл не заменяет аналитика. Он упаковывает повторяющуюся часть работы: контекст, порядок действий, ограничения и проверки, которые иначе приходится объяснять заново в каждом запросе.
P. S. А ещё у нас в компании есть скилл, который помогает создавать скиллы. Да, вот такая рекурсия)