Навык — это папка с файлом SKILL.md внутри: короткая YAML-шапка и инструкции в Markdown. Время уходит на инструкции, а прочтут их или нет, решает описание. Оно сопоставляется с текущей задачей, поэтому описание, которое говорит, о чём навык, но никогда — когда к нему обращаться, будет лежать без дела сколь угодно долго, и никакой ошибки, объясняющей почему, не появится. Этот конструктор пишет файл и строже всего проверяет именно это поле: названа ли ситуация-триггер, хватает ли длины для сопоставления, не потрачены ли впустую первые слова. Имя сверяется с правилами именования папок, а инструкции — с той длиной, ниже которой они редко что-либо меняют.
Возможности
Имя сверяется с правилами папок, предлагается исправленный вариант
Описание проверяется на фразу-триггер — именно она вызывает сопоставление
Предупреждает, когда описание слишком короткое, чтобы нести сигнал
Необязательный список инструментов выбирается, а не набирается
Оценка, отделяющая блокирующие ошибки от рекомендаций
Точный путь, по которому должен лежать файл
Frontmatter правильно закавычен: двоеточие не разрывает значение
Скачивается как SKILL.md, готовый к размещению
Как использовать Конструктор навыков
Назовите навык строчными буквами через дефис
Напишите описание, где сказано и что он делает, и когда его применять
Напишите инструкции в Markdown
Прочтите замечания и скачайте SKILL.md
Пример
Ввод
name: release-notes
Результат
description: Writes release notes from a range of git commits. Use when the user asks for a changelog.
Оборот «Используйте, когда…» превращает тему в триггер.
Частые ошибки и устранение неполадок
Навык словно никогда не используется. — Почти всегда дело в описании. Оно должно говорить, когда навык применим, теми словами, которыми человек действительно пользуется: типы файлов, названия задач, формулировки, которые он наберёт.
Имя отклонено. — Оно же служит именем папки, поэтому допустимы только строчные буквы, цифры и одиночные дефисы. Если ваше не подходит, предлагается исправленный вариант.
В описании есть двоеточие, и файл ломается. — Так быть не должно — значения при необходимости берутся в кавычки. Если правите файл вручную, закавычивайте всё, где есть двоеточие с пробелом.
Навык загружается, но ничего не меняет. — Очень короткие инструкции редко сдвигают поведение. Скажите, что произвести, как работать и чего не делать.
Часто задаваемые вопросы
Каким должно быть хорошее описание навыка?
Оно отвечает на два вопроса в одном-двух предложениях: что навык делает и когда его применять. Сопоставляется вторая половина, поэтому называйте типы файлов, саму задачу и то, как об этом сказал бы человек. «Помогает с документами» не совпадает ни с чем конкретным.
Куда кладётся файл?
В папку с именем навыка, внутри каталога навыков. Путь показан под редактором и обновляется по мере ввода имени. Имя папки и поле name должны совпадать.
Стоит ли задавать список разрешённых инструментов?
Только если навыку действительно нужно меньше инструментов, чем есть у сессии. Пустой список означает наследование доступного, и обычно это то, что нужно; сужение — способ удержать узкий навык узким.
Какой длины должны быть инструкции?
Ровно настолько, чтобы быть конкретными, и не длиннее. Несколько фраз редко меняют поведение; несколько страниц начинают просматривать по диагонали. Разделы с заголовками переживают правки лучше одного длинного блока.
Проверяется ли файл где-то ещё?
Загрузчик спокойно примет файл со слабым описанием — в этом и беда. Позже ничто не сообщит, что навык невозможно сопоставить, поэтому проверять и стоит до публикации.
Связанные инструменты
Линтер навыков — Вставьте SKILL.md и выясните, что мешает ему сопоставиться с задачей.
Конструктор субагентов — Соберите файл определения субагента с его инструментами и моделью.