Skill Maker

skill-maker — Создание навыков

Описание

Мета-навык для создания новых навыков агентов, соответствующих открытому стандарту agentskills.io.

Когда активировать

• Пользователь хочет создать новый навык для агента
• Есть рабочий процесс, который нужно превратить в навык
• Нужен черновик, тесты или итерация существующего навыка

Философия

> Навык — это не код, а инструкция. Хороший навык объясняет не только «что делать», но и «почему».

Принципы создания навыков

1. Ясность. Описание должно быть однозначным — ни двусмысленностей, ни расплывчатых формулировок.
2. Практичность. Навык должен реально работать, а не быть теоретическим упражнением.
3. Итеративность. Первый черновик почти всегда требует доработки — тестируй и улучшай.
4. Соответствие стандарту. Следуй спецификации agentskills.io.

Обязательный цикл

Шаг 1: Определение намерений

Начни с понимания целей пользователя. Возможно, в истории чата уже есть рабочий процесс, который нужно превратить в навык. Извлеки из контекста: используемые инструменты, последовательность шагов, исправления пользователя, форматы ввода/вывода.

1. Что этот навык должен позволить делать Koda?
2. Когда навык должен срабатывать? (фразы пользователя, контекст).
3. Какой ожидаемый формат вывода?
4. Нужно ли настраивать тест-кейсы?

Навыки с объективно проверяемым результатом (преобразование файлов, извлечение данных, генерация кода) выигрывают от тестов. Для субъективных навыков (стиль письма, искусство) тесты часто не нужны.

Шаг 2: Интервью и исследование

Проактивно спрашивай о пограничных случаях, форматах, примерах файлов и критериях успеха. Не пиши тесты, пока не прояснишь эти детали.

Проверьте доступные MCP и инструменты — используйте их для поиска документации или лучших практик.

Шаг 3: Написание SKILL.md

Документ должен быть на русском языке.

Заполни frontmatter:

• name: Идентификатор навыка.

Требования: латиница в нижнем kebab-case, 1-64 символов, должно совпадать с именем директории

• description: Когда срабатывает и что делает.

Требования: 1-1024 символов, краткое описание навыка на русском языке. Это основной механизм активации. Пиши описание немного «настойчивым», чтобы Koda не игнорировал навык там, где он полезен.

Проверка имени

✅ Валидно: code-review, sprint-planner, github-flow
❌ Невалидно: Code-Review (верхний регистр), -my-skill (дефис в начале), my--skill (двойной дефис)

Шаг 4: Руководство по написанию навыка

Анатомия навыка

.agents/skills//
    └── SKILL.md
        ├── YAML frontmatter (name, description)
        └── Markdown-инструкции

Паттерны написания

• Метаданные (имя + описание) — всегда в контексте (~100 слов).
• Тело SKILL.md — в контексте при срабатывании (<500 строк).

Используй повелительное наклонение. Объясняй «почему» нужно делать именно так — современные LLM лучше работают, когда понимают логику ограничений.

Навыки не должны содержать вредоносного кода или вводить пользователя в заблуждение.

Чек-лист

• [ ] Имя навыка соответствует директории (kebab-case)
• [ ] Описание понятное, конкретное, 1-1024 символа
• [ ] Описание на русском языке
• [ ] Frontmatter заполнен (name, description, license, metadata)
• [ ] Навык протестирован на нескольких промптах
• [ ] Пользователь доволен результатом

Scope

• Применять только когда пользователь явно просит создать навык
• Это мета-навык — он не выполняет задачи, а создаёт инструкции для других навыков
• После создания навыка предложи пользователю протестировать его

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Major-Woolfi
• Source: Major-Woolfi/Skillsfor_AI-Agents
• License: MIT

Install and usage instructions live in the source repository linked above.