FreeAILab free-ai-lab

Руководство по написанию SKILL.md

Продвинутый туториал

Разбор полей + 10 готовых шаблонов + продвинутые советы для более стабильных скиллов.

Одним предложением: SKILL.md состоит всего из трёх частей: заголовок «говорит ИИ, что это за скилл и когда его применять», основная часть — «как именно это сделать», а примеры показывают, «как выглядит результат». В этой статье разобрано каждое поле, а затем даны 10 шаблонов, которые можно копировать сразу.

Новичкам стоит начать с четырёхшагового туториала по созданию; эта статья — справочник для продвинутых.

Общая структура

--- name: skill-name ← идентификатор строчными буквами в kebab-case description: что делает + когда применять ← самое важное; по этому полю ИИ решает, активировать ли скилл --- # Главный заголовок (основная часть: шаги, правила, границы) ## Примеры (ввод → вывод, чтобы показать ИИ целевой уровень)
Frontmatter (заголовок)

name + description, в формате YAML

Основная часть

конкретные шаги + границы + правила; чем конкретнее, тем стабильнее

Примеры

ввод → идеальный вывод: задают стандарт, на который ориентируется ИИ

Как правильно писать поля заголовка

description — ключ ко всему

От этого поля зависит, «когда ИИ вспомнит об этом скилле». Чем ближе оно к собственным словам пользователя, тем выше процент успеха.

❌ Слишком размыто (ИИ не знает, когда его применить)
description: Помогает писать рекламные тексты
✅ Точно (полностью покрывает сценарии срабатывания)
description: Пишет продающие посты о продукте в формате коротких вирусных заметок. Использовать, когда пользователь говорит «напиши пост для соцсетей», «помоги составить рекламный текст о продукте» или вставляет информацию о продукте.
Соглашение об именах в name

Строчные буквы + дефисы (например, weekly-report-writer), чтобы назначение было понятно с первого взгляда. Ни пробелов, ни заглавных букв, ни нелатинских символов.

10 готовых шаблонов под сценарии

Сохраните любой из шаблонов ниже как папку с файлом SKILL.md внутри — и он заработает; меняйте только примеры:

1️⃣ Скилл для заметок со встреч
--- name: meeting-notes description: Превращает протоколы встреч в структурированные заметки. Использовать, когда пользователь вставляет заметки о встрече или говорит «структурируй сегодняшнюю встречу». --- # Заметки со встречи 1. Определить и показать: тема, время, участники 2. Разделить на три блока: «решения / задачи к выполнению / нерешённые вопросы» 3. Одна задача на человека, формат: ответственный + что сделать + срок (недостающую информацию помечать [TBD]) 4. Не добавлять информацию, которой нет в заметках ## Пример Ввод: На сегодняшней встрече решили добавить продукту функцию экспорта; я отвечаю за бэкенд, Сяо Чжан — за фронтенд, демо в пятницу... Вывод: ### Решения - Добавить продукту функцию экспорта ### Открытые задачи - Мин: сделать экспорт на бэкенде (срок [TBD])
2️⃣ Скилл для полировки писем (деловой тон)
--- name: email-polisher description: Переделывает черновики писем в профессиональные деловые письма. Использовать, когда пользователь вставляет черновик письма или говорит «отполируй моё письмо». --- # Полировка писем 1. Сохранить все существенные информационные пункты 2. Усилить вежливость обращения, вступления и заключения 3. Сокращать длинные предложения; одна мысль на абзац 4. Вывод: отполированное письмо + сводка изменений не более чем в 3 строки ## Пример Ввод: Привет, шеф, обсуждённое сотрудничество подтверждено, когда подпишете? Вывод: Уважаемый господин Ван! Подтверждаем готовность продолжить ранее обсуждённое сотрудничество. Сообщите, пожалуйста, удобное для вас время — мы готовы организовать подписание в соответствии с вашими пожеланиями. С уважением!
3️⃣ Скилл недельного отчёта
--- name: weekly-report description: Превращает разрозненные рабочие заметки в ясный структурированный недельный отчёт. Использовать, когда пользователь вставляет смесь заметок или говорит «напиши мой отчёт за неделю». --- # Создание недельного отчёта 1. Разложить заметки по рубрикам «результаты недели / возникшие проблемы / планы на следующую неделю» 2. Отсортировать результаты по важности, к каждому — подтверждающие метрики (недостающие пометить [TBD]) 3. Предложить два варианта заголовка на выбор 4. Придерживаться фактов; не выдумывать событий, которых не было ## Пример…
4️⃣ Скилл для полировки резюме
--- name: resume-polisher description: Доводит формулировки резюме до более профессионального и измеримого вида. Использовать, когда пользователь вставляет резюме или говорит «улучши моё резюме». --- # Полировка резюме 1. Начинать с глаголов действия (например, «руководил», «внедрил»), избегать первого лица 2. По возможности измерять результаты (числа, проценты); иначе оставить как есть 3. Держать каждый пункт опыта в 1–2 строки; убирать лишнее и слова-балласты 4. Вывод: отполированный список + примечание о том, что изменено и почему
5️⃣ Скилл для код-ревью фронтенда
--- name: frontend-code-review description: Проверяет фронтенд-код на сопровождаемость и доступность. Использовать, когда пользователь говорит «посмотри этот код» или вставляет код. --- # Код-ревью фронтенда 1. Проверить каждый элемент: читаемость / доступность (aria) / производительность (повторные рендеры) / безопасность (XSS) 2. По каждой проблеме указать: файл + строка, суть проблемы и код предлагаемого решения 3. Отсортировать вывод по серьёзности 4. Если проблем нет, явно сообщить «проблем не найдено»
6️⃣ Скилл для создания промптов генерации изображений
--- name: image-prompt-writer description: Превращает описание сцены в качественный английский промпт для ИИ-генерации изображений. Использовать, когда пользователь говорит «напиши мне промпт для картинки». --- # Промпт для генерации изображений 1. Вывод на английском, структурировано: объект + окружение + свет + композиция + стиль + теги качества 2. Завершать фиксированными тегами качества: high quality, 4k 3. Автоматически подбирать подходящий дескриптор стиля под сцену (реализм / иллюстрация / 3D / плакат) 4. После промпта добавить пояснение в 2 строки
7️⃣ Скилл для упорядочивания конспектов
--- name: study-notes description: Превращает разрозненные учебные материалы в структурированные заметки и карточки для запоминания. Использовать, когда пользователь вставляет материалы или говорит «структурируй мои конспекты». --- # Конспекты лекций 1. Извлечь ключевые понятия, каждое начинать с «определения в одно предложение» 2. Сгруппировать иерархически по темам, дополнить примерами 3. Составить 5 карточек «вопрос — ответ» 4. Вывод в Markdown, готовый к импорту в приложение для заметок
8️⃣ Скилл для интерпретации данных
--- name: data-interpreter description: Интерпретирует набор данных (таблицу/числа) и даёт выводы и рекомендации. Использовать, когда пользователь вставляет данные или говорит «проанализируй эти данные». --- # Интерпретация данных 1. Сначала общая картина, затем списком заметные тренды/выбросы 2. Отличать «факты из данных» от «выводов»; помечать каждый вывод 3. Предложить минимум 3 выполнимых следующих шага 4. Сравнения оформлять таблицей
9️⃣ Скилл для сценариев коротких видео
--- name: short-video-script description: Превращает тему в озвучиваемый сценарий короткого видео на 30–60 секунд. Использовать, когда пользователь говорит «напиши сценарий для короткого видео» или «переделай этот текст в видеосценарий». --- # Сценарий короткого видео 1. Структура: 3-секундный хук + 15-секундное ядро + финальный призыв к действию 2. Разговорная речь: короткие фразы, непринуждённый тон, отметки пауз 3. Каждые 10 секунд — визуальная подсказка (смена кадра / субтитр) 4. Держаться в пределах 45 секунд, около 300 слов
🔟 Скилл для планирования путешествий
--- name: travel-planner description: Составляет маршрут по длительности/бюджету/предпочтениям. Использовать, когда пользователь говорит «помоги спланировать путешествие» или «сделай мне гид по поездке». --- # Планирование путешествия 1. Сначала уточнить вводные: число дней, бюджет, точка старта и назначения, предпочтения (еда / природа / культура) 2. Планировать каждый день по блокам утро/день/вечер: достопримечательности + транспорт + питание 3. Для каждой достопримечательности пометить планируемое время посещения 4. Включить: таблицу с примерным бюджетом + 3 практических совета (например, брони/погода)

Смысл шаблонов: превратить «часто повторяющиеся рабочие процессы» в скилл — это более продвинутое использование, чем складывать промпты в закладки. Установили один раз — и ИИ каждый раз следует вашему стандарту.

Продвинутые советы: как сделать скиллы стабильнее

  • Добавляйте «контрпримеры»: написать в основной части «не делай X» заметно уменьшает выходы за рамки (например, «не выдумывай данные», «не меняй имена, если не уверен»)
  • Задавайте формат вывода: прямо требуйте «табличный вид», «заголовки ###», «не больше 3 строк» — структура вывода ИИ становится стабильнее
  • Закрепляйте примерами в конце: примеры — не украшение, а образец, по которому ИИ выравнивается на производственный стандарт
  • Используйте scripts/ для механической работы: вычисления и повторяющееся форматирование отдавайте скриптам; SKILL.md только «дирижирует»
  • Дорабатывайте итеративно: протестировать 3 ввода → вписать в основную часть места, где ИИ ошибся → снова протестировать; скиллы становятся точнее, чем больше вы ими пользуетесь

Что читать дальше