Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Skill Builder / Creator — это руководство по созданию высококачественных навыков с модульной структурой, постепенным раскрытием информации и эффективным использованием токенов.
Когда использовать
Используйте этот подход, когда необходимо создать новый навык или улучшить существующий. Агент помогает выстроить структуру, проверить содержание и обеспечить качество.
Хранение данных
Если требуется отслеживание проектов, можно создать папку в домашней директории пользователя. Структура описана в файле memory-template.md.
Агент не создает файлы автоматически — всегда сначала запрашивается подтверждение пользователя.
Архитектура навыка
Каждый навык должен следовать следующей структуре:
skill-name/
├── SKILL.md # Основные инструкции (КРАТКО)
├── [topic].md # Детали по запросу
└── references/ # Дополнительные материалы (опционально)Быстрая навигация
- Процесс настройки —
setup.md - Отслеживание проектов —
memory-template.md - Паттерны и примеры —
patterns.md
Ключевые правила
1. SKILL.md должен быть кратким
Оптимальный размер — 30–50 строк, максимум 80. Все детали выносите в дополнительные файлы. Каждая строка должна оправдывать свою «стоимость» в токенах.
2. Прогрессивное раскрытие информации
Уровень 1: Метаданные (название + описание) — всегда загружаются
Уровень 2: Основной текст SKILL.md — при активации навыка
Уровень 3: Дополнительные файлы — по запросу3. Описание критически важно
Одно предложение (15–25 слов), начинающееся с глагола действия. Описывает возможности, а не триггеры.
| ❌ Неправильно | ✅ Правильно |
|---|---|
| «Use when user needs PDFs» | «Обрабатывает, объединяет и извлекает содержимое PDF» |
| «Helper for Docker» | «Собирает, разворачивает и отлаживает Docker-контейнеры» |
| «Git guide» | «Управляет ветками, решает конфликты и автоматизирует процессы» |
4. Обязательная структура
- Frontmatter: name, slug, version, description
- Раздел
## When to Use— когда активируется навык - Раздел
## Core Rules— 3–7 ключевых правил
5. Выносите детали в отдельные файлы
Если блок превышает 20 строк или используется не всегда — вынесите его в отдельный файл и добавьте ссылку в Quick Reference.
6. Без дублирования
Каждая информация должна находиться только в одном месте. SKILL.md ссылается на файлы, а не копирует их содержимое.
7. Тестируйте перед публикацией
Прочитайте навык так, будто вы агент, который видит его впервые. Все ли инструкции понятны и действительно необходимы?
Типичные ошибки при создании навыков
| Ошибка | Почему это плохо | Как исправить |
|---|---|---|
| Объяснение базовых понятий | Модели это уже знают | Объясняйте КОГДА и КАК использовать |
| «Use when…» в описании | Тратит лишние токены | Используйте глаголы действия |
| Списки ключевых слов | Выглядит как спам | Одно четкое предложение |
| Шаблоны внутри файла | Раздувает SKILL.md | Вынесите в отдельный файл |
| Размытые инструкции | Может вызвать подозрения | Уточняйте, какие данные использовать |
| Создание файлов без указания | Флаг безопасности | Добавьте раздел Data Storage |
Связанные навыки
Можно установить при подтверждении пользователя:
skill-manager— управление установленными навыкамиskill-update— обновление навыковskill-test— локальное тестирование навыков
Обратная связь
- Если было полезно:
clawhub star skill-builder - Для обновлений:
clawhub sync
Файл из источника