Skip to content

diana-AI-coder/ai-skill-creator

universal-skill-creator

Verified

Создание новых навыков, улучшение существующих и проверка их качества. Используй, когда пользователь хочет создать навык с нуля, отредактировать или оптимизировать существующий навык, проверить качество навыка или адаптировать его под другой кодовый агент.

FileKindSize
SKILL.mdskill md14.8 KB
---
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` — непустая строка |
| Конкретность описания | Описание говорит **что делает** и **когда использовать**, а не просто «помогает с документами» |
| Убедительность инструкций | Инструкции пошаговые, конкретные, выполнимые агентом |
| Наличие примеров | Есть хотя бы один конкретный пример (если навык этого требует) |
| Полнота | Навык покрывает типичные и пограничные случаи |
| Переносимость | Навык не зависит от специфических инструментов одной платформы |
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall