diana-AI-coder/ai-skill-creator
universal-skill-creator
VerifiedСоздание новых навыков, улучшение существующих и проверка их качества. Используй, когда пользователь хочет создать навык с нуля, отредактировать или оптимизировать существующий навык, проверить качество навыка или адаптировать его под другой кодовый агент.
Универсальный мастер создания навыков
Этот навык помогает создавать, улучшать и проверять навыки для любого кодового агента, который поддерживает формат SKILL.md (Qwen Code, Cline, Cursor и другие).
На высоком уровне процесс создания навыка проходит через эти этапы:
- Выясни, что должен уметь навык.
- Уточни детали через вопросы.
- Напиши черновик
SKILL.md. - Протестируй на конкретных примерах.
- Покажи результаты пользователю, получи отзыв.
- Улучши черновик.
- Повторяй тестирование и улучшение, пока результат не станет удовлетворительным.
Твоя задача — определить, на каком этапе находится пользователь, и помочь продвинуться дальше. Если пользователь уже имеет черновик — переходи к тестированию. Если пользователь хочет только «поиграть с идеей» — работай в свободном режиме без строгого следования этапам.
Адаптация языка под пользователя
Мастер создания навыков может использоваться людьми с разным уровнем технической подготовки. Подстраивай свой язык:
- В неясном случае — избегай технического жаргона или кратко объясняй термины.
- Если пользователь демонстрирует опыт — можешь использовать профессиональные термины.
- Всегда обращай внимание на сигналы в сообщениях пользователя, чтобы понять его уровень.
Создание нового навыка
Шаг 1. Проясни задачу
Прежде чем писать что-либо, ответь на четыре вопроса:
- Что этот навык должен уметь? Какая задача или рабочий процесс будет автоматизироваться?
- В каких ситуациях навык должен запускаться? Какие фразы, слова или контексты должны привести к его срабатыванию?
- Какой формат результата ожидается? Что агент должен выдать после выполнения навыка?
- Нужны ли тесты? Если у навыка объективный результат (обработка файлов, извлечение данных, генерация кода) — предложи сделать тесты. Если результат субъективный (стиль письма, дизайн) — тесты могут не понадобиться. Пусть пользователь решит.
Если часть ответов уже есть в истории разговора — извлеки их оттуда. Недостающие — спроси у пользователя.
Шаг 2. Уточни детали
Задай уточняющие вопросы:
- Какие есть типовые и пограничные случаи использования?
- Какой формат входных данных? Есть ли примеры файлов?
- Каковы критерии успеха? Как поймём, что навык работает правильно?
- Есть ли зависимости или связанные процессы?
Не переходи к написанию, пока не получил достаточно информации. Не гадай — спрашивай.
Шаг 3. Напиши черновик SKILL.md
На основе ответов создай черновик со следующей структурой:
Фронтматтера (YAML, в начале файла):
---
name: имя-навыка
description: Краткое описание того, что делает навык и когда его использовать
---
Поля:
name— идентификатор навыка. Используй строчные буквы, цифры и дефисы. Пример:pdf-extractor,data-analyst.description— строка определения триггера. Это главный механизм вызова навыка. Должна содержать и что делает навык, и конкретные ситуации для его использования. Включай ключевые слова, которые пользователь естественно упомянет.
Тело инструкции (Markdown после фронтматтеры):
| Элемент | Обязательность | Описание |
|---|---|---|
# Заголовок | Обязательно | Название навыка, совпадающее по смыслу с name |
| Общее описание | Обязательно | Краткое введение: что делает навык, общая схема работы |
| Пошаговые инструкции | Обязательно | Основная часть: конкретные шаги, которые агент должен выполнить |
| Примеры использования | Опционально | Конкретные примеры запросов и ожидаемых ответов |
| Дополнительные файлы | Опционально | Ссылки на справочные документы, скрипты или шаблоны рядом с SKILL.md |
| Важные замечания | Опционально | Предупреждения, ограничения, особенности |
Принципы хорошего SKILL.md:
- Пиши понятным, конкретным языком.
- Инструкции должны быть пошаговыми и выполнимыми.
- Используй примеры для иллюстрации.
- Указывай, что является обязательным, а что опциональным.
- Не полагайся на возможности, которые могут быть только у одной конкретной платформы.
Шаг 4. Протестируй
Составь 3–5 тестовых промптов, которые охватывают:
- типичный случай использования;
- пограничный или сложный случай;
- вариант, где навык должен помочь, но запрос сформулирован неочевидно.
Для каждого промпта:
- Запусти его в диалоге с навыком и запиши результат.
- Запусти тот же промпт без навыка и запиши результат.
- Заметь различия: что стало лучше, что ухудшилось, что осталось без изменений.
Мини-валидация — быстро проверь:
- Фронтматтера открывается и закрывается тройными дефисами (
---). - Поля
nameиdescriptionзаполнены и не пустые. - Тело содержит хотя бы один заголовок и инструкции.
Шаг 5. Оценка и итерация
Покажи пользователю результаты тестирования:
- Для каждого тестового промпта кратко опиши: что сделал агент с навыком и что без.
- Укажи, где навык дал заметное улучшение.
- Отметь, где улучшений нет или результат хуже.
Спроси пользователя: что из этого выглядит хорошо, а что нужно улучшить?
Внеси изменения в SKILL.md:
- Доработай формулировки, которые оказались неясны.
- Добавь уточнения для случаев, где агент действовал неправильно.
- При необходимости — добавь примеры или предостережения.
После изменений — повтори Шаг 4. Продолжай цикл, пока пользователь не скажет, что доволен, или пока новые итерации перестанут давать заметное улучшение.
Оптимизация описания (этап триггеров)
После того как навык работает хорошо, предложи оптимизировать поле description для более точного срабатывания.
Шаг 1. Составь проверочные запросы
Подготовь набор из примерно 10–20 запросов, среди которых:
- Должны вызывать навык (8–10 штук): разные формулировки одной и той же потребности — формальные и разговорные, с опечатками, аббревиатурами, разной длины. Включай случаи, когда пользователь не называет навык прямо, но описывает потребность.
- Не должны вызывать навык (8–10 штук): запросы из соседних областей, с похожими ключевыми словами, но другой целью. Самый ценный тип — «почти совпадение», где наивный поиск по ключевым словам ошибся бы.
Плохие примеры отрицательных запросов: «Напиши функцию Фибоначчи» для проверки навыка работы с PDF — слишком очевидно нерелевантный запрос. Хорошие примеры отрицательных запросов: «Конвертируй этот PDF в текст» для навыка, который анализирует содержимое, а не конвертирует — тонкая грань.
Шаг 2. Проверь срабатывание
Для каждого запроса из набора проверь: вызвал ли он навык или нет? Сопоставь с ожидаемым поведением.
Выяви промахи:
- Ложные срабатывания — навык вызвался, когда не должен.
- Пропуски — навык не вызвался, когда должен.
Шаг 3. Скорректируй описание
На основе результатов измени description:
- Если навык не срабатывает на нужные запросы — добавь конкретнее формулировки, синонимы, контексты.
- Если навык срабатывает на ненужные запросы — сузь определение, убери слишком общие слова, уточни границы.
Повтори проверку. Остановись, когда точность срабатывания будет приемлемой.
Улучшение существующего навыка
Если пользователь пришёл с готовым навыком — работай по упрощённому процессу:
- Прочитай текущий
SKILL.mdи пойми его назначение. - Спроси, что не устраивает — навыки не срабатывают, даёт плохие результаты, слишком общий/узкий?
- Протестируй на нескольких промптах, чтобы самостоятельно увидеть проблему.
- Предложи конкретные изменения — отредактируй описание, уточни инструкции, добавь примеры.
- Проверь после изменений — запусти те же промпты и убедись, что стало лучше.
- Повторяй до достижения результата.
Проверка качества навыка
Используй эти критерии для оценки качества готового навыка:
| Критерий | Что проверять |
|---|---|
| Валидность фронтматтеры | Открывающие --- на первой строке, закрывающие --- перед текстом, корректный YAML |
| Обязательные поля | name — непустая строка, description — непустая строка |
| Конкретность описания | Описание говорит что делает и когда использовать, а не просто «помогает с документами» |
| Убедительность инструкций | Инструкции пошаговые, конкретные, выполнимые агентом |
| Наличие примеров | Есть хотя бы один конкретный пример (если навык этого требует) |
| Полнота | Навык покрывает типичные и пограничные случаи |
| Переносимость | Навык не зависит от специфических инструментов одной платформы |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |