Как написать свой скилл для AI-агента

Скилл это способ дать агенту многоразовый навык. Вместо того чтобы каждый раз объяснять задачу в чате, вы кладете инструкции в файл SKILL.md, и агент подхватывает их сам, когда задача подходит.

Из чего состоит скилл

Минимальный скилл это одна папка с файлом SKILL.md. В начале файла идет блок метаданных с полями name и description. Дальше сам текст: что умеет скилл, когда его применять и по каким шагам работать. По желанию рядом кладут вспомогательные файлы, справочники и скрипты, на которые ссылается инструкция.

Как написать SKILL.md

Главное поле это description. По нему агент решает, вызывать скилл или нет, поэтому опишите триггеры конкретно: какие запросы и ситуации подходят. Текст пишите по делу, без общих слов. Если скилл делает несколько вещей, разбейте на режимы с явными триггерами.

• Description с конкретными триггерами.
• Один скилл под одну задачу, сложное дробите на режимы.
• Короткие шаги и примеры вместо длинных рассуждений.
• Вспомогательные файлы рядом, ссылки на них из текста.

Как подключить к агенту

В Claude Code скилл кладут в каталог скиллов, папку skills в проекте или в домашней директории, либо ставят как плагин через маркетплейс. Cursor и Codex тоже читают папку со скиллами. Имя папки должно совпадать с полем name в SKILL.md.

Посмотрите на готовых примерах

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