diana-AI-coder/ai-skill-creator
universal-skill-creator
VerifiedСоздание новых навыков, улучшение существующих и проверка их качества. Используй, когда пользователь хочет создать навык с нуля, отредактировать или оптимизировать существующий навык, проверить качество навыка или адаптировать его под другой кодовый агент.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.8 KB |
SKILL.md
View on GitHub---
name: universal-skill-creator
description: Создание новых навыков, улучшение существующих и проверка их качества. Используй, когда пользователь хочет создать навык с нуля, отредактировать или оптимизировать существующий навык, проверить качество навыка или адаптировать его под другой кодовый агент.
---
# Универсальный мастер создания навыков
Этот навык помогает создавать, улучшать и проверять навыки для любого кодового агента, который поддерживает формат `SKILL.md` (Qwen Code, Cline, Cursor и другие).
На высоком уровне процесс создания навыка проходит через эти этапы:
1. Выясни, что должен уметь навык.
2. Уточни детали через вопросы.
3. Напиши черновик `SKILL.md`.
4. Протестируй на конкретных примерах.
5. Покажи результаты пользователю, получи отзыв.
6. Улучши черновик.
7. Повторяй тестирование и улучшение, пока результат не станет удовлетворительным.
Твоя задача — определить, на каком этапе находится пользователь, и помочь продвинуться дальше. Если пользователь уже имеет черновик — переходи к тестированию. Если пользователь хочет только «поиграть с идеей» — работай в свободном режиме без строгого следования этапам.
## Адаптация языка под пользователя
Мастер создания навыков может использоваться людьми с разным уровнем технической подготовки. Подстраивай свой язык:
- В **неясном случае** — избегай технического жаргона или кратко объясняй термины.
- Если пользователь **демонстрирует опыт** — можешь использовать профессиональные термины.
- Всегда обращай внимание на сигналы в сообщениях пользователя, чтобы понять его уровень.
---
## Создание нового навыка
### Шаг 1. Проясни задачу
Прежде чем писать что-либо, ответь на четыре вопроса:
1. **Что этот навык должен уметь?** Какая задача или рабочий процесс будет автоматизироваться?
2. **В каких ситуациях навык должен запускаться?** Какие фразы, слова или контексты должны привести к его срабатыванию?
3. **Какой формат результата ожидается?** Что агент должен выдать после выполнения навыка?
4. **Нужны ли тесты?** Если у навыка объективный результат (обработка файлов, извлечение данных, генерация кода) — предложи сделать тесты. Если результат субъективный (стиль письма, дизайн) — тесты могут не понадобиться. Пусть пользователь решит.
Если часть ответов уже есть в истории разговора — извлеки их оттуда. Недостающие — спроси у пользователя.
### Шаг 2. Уточни детали
Задай уточняющие вопросы:
- Какие есть типовые и пограничные случаи использования?
- Какой формат входных данных? Есть ли примеры файлов?
- Каковы критерии успеха? Как поймём, что навык работает правильно?
- Есть ли зависимости или связанные процессы?
Не переходи к написанию, пока не получил достаточно информации. Не гадай — спрашивай.
### Шаг 3. Напиши черновик `SKILL.md`
На основе ответов создай черновик со следующей структурой:
**Фронтматтера (YAML, в начале файла):**
```
---
name: имя-навыка
description: Краткое описание того, что делает навык и когда его использовать
---
```
Поля:
- **`name`** — идентификатор навыка. Используй строчные буквы, цифры и дефисы. Пример: `pdf-extractor`, `data-analyst`.
- **`description`** — строка определения триггера. Это главный механизм вызова навыка. Должна содержать **и** что делает навык, **и** конкретные ситуации для его использования. Включай ключевые слова, которые пользователь естественно упомянет.
Тело инструкции (Markdown после фронтматтеры):
| Элемент | Обязательность | Описание |
|---------|---------------|----------|
| `# Заголовок` | Обязательно | Название навыка, совпадающее по смыслу с `name` |
| Общее описание | Обязательно | Краткое введение: что делает навык, общая схема работы |
| Пошаговые инструкции | Обязательно | Основная часть: конкретные шаги, которые агент должен выполнить |
| Примеры использования | Опционально | Конкретные примеры запросов и ожидаемых ответов |
| Дополнительные файлы | Опционально | Ссылки на справочные документы, скрипты или шаблоны рядом с `SKILL.md` |
| Важные замечания | Опционально | Предупреждения, ограничения, особенности |
Принципы хорошего `SKILL.md`:
- Пиши понятным, конкретным языком.
- Инструкции должны быть пошаговыми и выполнимыми.
- Используй примеры для иллюстрации.
- Указывай, что является обязательным, а что опциональным.
- Не полагайся на возможности, которые могут быть только у одной конкретной платформы.
### Шаг 4. Протестируй
Составь 3–5 тестовых промптов, которые охватывают:
- типичный случай использования;
- пограничный или сложный случай;
- вариант, где навык должен помочь, но запрос сформулирован неочевидно.
Для каждого промпта:
1. Запусти его в диалоге **с навыком** и запиши результат.
2. Запусти тот же промпт **без навыка** и запиши результат.
3. Заметь различия: что стало лучше, что ухудшилось, что осталось без изменений.
Мини-валидация — быстро проверь:
- Фронтматтера открывается и закрывается тройными дефисами (`---`).
- Поля `name` и `description` заполнены и не пустые.
- Тело содержит хотя бы один заголовок и инструкции.
### Шаг 5. Оценка и итерация
Покажи пользователю результаты тестирования:
- Для каждого тестового промпта кратко опиши: что сделал агент с навыком и что без.
- Укажи, где навык дал заметное улучшение.
- Отметь, где улучшений нет или результат хуже.
Спроси пользователя: **что из этого выглядит хорошо, а что нужно улучшить?**
Внеси изменения в `SKILL.md`:
- Доработай формулировки, которые оказались неясны.
- Добавь уточнения для случаев, где агент действовал неправильно.
- При необходимости — добавь примеры или предостережения.
После изменений — повтори Шаг 4. Продолжай цикл, пока пользователь не скажет, что доволен, или пока новые итерации перестанут давать заметное улучшение.
---
## Оптимизация описания (этап триггеров)
После того как навык работает хорошо, предложи оптимизировать поле `description` для более точного срабатывания.
### Шаг 1. Составь проверочные запросы
Подготовь набор из примерно 10–20 запросов, среди которых:
- **Должны вызывать навык (8–10 штук):** разные формулировки одной и той же потребности — формальные и разговорные, с опечатками, аббревиатурами, разной длины. Включай случаи, когда пользователь не называет навык прямо, но описывает потребность.
- **Не должны вызывать навык (8–10 штук):** запросы из соседних областей, с похожими ключевыми словами, но другой целью. Самый ценный тип — «почти совпадение», где наивный поиск по ключевым словам ошибся бы.
**Плохие примеры отрицательных запросов:** «Напиши функцию Фибоначчи» для проверки навыка работы с PDF — слишком очевидно нерелевантный запрос.
**Хорошие примеры отрицательных запросов:** «Конвертируй этот PDF в текст» для навыка, который **анализирует** содержимое, а не конвертирует — тонкая грань.
### Шаг 2. Проверь срабатывание
Для каждого запроса из набора проверь: вызвал ли он навык или нет? Сопоставь с ожидаемым поведением.
Выяви промахи:
- Ложные срабатывания — навык вызвался, когда не должен.
- Пропуски — навык не вызвался, когда должен.
### Шаг 3. Скорректируй описание
На основе результатов измени `description`:
- Если навык не срабатывает на нужные запросы — добавь конкретнее формулировки, синонимы, контексты.
- Если навык срабатывает на ненужные запросы — сузь определение, убери слишком общие слова, уточни границы.
Повтори проверку. Остановись, когда точность срабатывания будет приемлемой.
---
## Улучшение существующего навыка
Если пользователь пришёл с готовым навыком — работай по упрощённому процессу:
1. **Прочитай текущий `SKILL.md`** и пойми его назначение.
2. **Спроси, что не устраивает** — навыки не срабатывают, даёт плохие результаты, слишком общий/узкий?
3. **Протестируй** на нескольких промптах, чтобы самостоятельно увидеть проблему.
4. **Предложи конкретные изменения** — отредактируй описание, уточни инструкции, добавь примеры.
5. **Проверь после изменений** — запусти те же промпты и убедись, что стало лучше.
6. **Повторяй** до достижения результата.
---
## Проверка качества навыка
Используй эти критерии для оценки качества готового навыка:
| Критерий | Что проверять |
|----------|---------------|
| Валидность фронтматтеры | Открывающие `---` на первой строке, закрывающие `---` перед текстом, корректный 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: 472k | 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: 322k | 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: 322k | 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: 322k | Updated | Claude CodeCodex | Verified | Install |