Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Skill Creator — это руководство по созданию эффективных навыков (skills), предназначенных для расширения возможностей AI-агентов за счёт специализированных знаний, рабочих процессов и интеграций инструментов.
О навыках (Skills)
Навыки — это модульные и самодостаточные пакеты, которые расширяют возможности агента, предоставляя специализированные знания, рабочие процессы и инструменты. Их можно рассматривать как «инструкции по внедрению» для конкретных задач или областей.
Благодаря навыкам универсальный AI превращается в специализированного агента, обладающего процедурными знаниями, которые невозможно полностью заложить в одну модель. :
Что включает в себя навык
- Рабочие процессы — пошаговые инструкции для выполнения задач
- Интеграции инструментов — взаимодействие с API, файлами и системами
- Экспертные знания — доменная логика, правила, архитектура
- Ресурсы — скрипты, шаблоны и вспомогательные материалы
Ключевые принципы
Простота — главный приоритет. Контекстное окно ограничено, поэтому добавляйте только действительно необходимую информацию.
- Предполагайте, что модель уже достаточно умна
- Добавляйте только недостающий контекст
- Предпочитайте короткие примеры длинным объяснениям
- Оценивайте ценность каждого блока информации
Баланс свободы. Уровень детализации должен соответствовать задаче:
- Высокая свобода — для гибких текстовых инструкций
- Средняя — для псевдокода и параметризованных решений
- Низкая — для строго определённых сценариев
Структура навыка
Каждый навык состоит из обязательного файла SKILL.md и опциональных ресурсов:
skill-name/ ├── SKILL.md │ ├── YAML-метаданные │ └── Markdown-инструкции └── resources/ ├── scripts/ ├── references/ └── assets/
SKILL.md содержит:
- Метаданные (name, description)
- Инструкции по использованию
Типы ресурсов
Скрипты (scripts/) — выполняемый код для повторяющихся задач.
Справочные материалы (references/) — документация, загружаемая по мере необходимости.
Ассеты (assets/) — файлы, используемые в итоговом результате (шаблоны, изображения и т.д.).
Чего не должно быть в навыке
- Лишней документации (README, changelog и т.д.)
- Описание процесса разработки
- Тестовые и вспомогательные материалы
Навык должен содержать только то, что необходимо агенту для выполнения задачи — ничего лишнего.
Принцип прогрессивного раскрытия
Контекст загружается по уровням:
- Метаданные — всегда в контексте
- SKILL.md — при активации навыка
- Ресурсы — по мере необходимости
Это позволяет эффективно использовать контекстное окно и избегать перегрузки. :
Процесс создания навыка
- Понять реальные сценарии использования
- Выделить повторяемые элементы
- Создать структуру навыка
- Реализовать ресурсы
- Написать SKILL.md
- Протестировать и упаковать
- Итеративно улучшать
Практические рекомендации
- Используйте императивный стиль инструкций
- Чётко описывайте, когда применять навык
- Выносите детали в отдельные файлы
- Избегайте дублирования информации
- Держите основной файл кратким
Хорошо спроектированный навык — это баланс между лаконичностью, структурой и практической полезностью.
Файл из источника