OpenClaw Skills: процедурная память для вашего омара
Skills в OpenClaw — это Markdown-файлы с YAML-frontmatter (как в Hermes), которые загружаются по триггеру и учат омара повторяющимся рабочим процессам. Написали один раз — используете вечно командой /skill name в любом чате.
1. Анатомия SKILL.md файла
# ~/.config/openclaw/skills/my-skill.md
---
name: my-skill # уникальное имя (для /skill my-skill)
description: "Use when..." # триггер для автозагрузки
tools: [Terminal, Git, HTTP] # какие инструменты доступны
model: "anthropic/claude-3.5-sonnet" # опционально: своя модель
---
# Инструкции для омара (markdown)
## Когда использовать
Описание ситуаций, когда омар должен загрузить этот скилл.
## Процедура
1. Шаг 1
2. Шаг 2
3. Шаг 3
## Rollback / Ошибки
Что делать если что-то пошло не так.
## Уведомления
Куда и что слать уведомления (Telegram, Slack, email).
2. Поле description — главный триггер
Омар решает загружать скилл или нет, основываясь на description. Пишите триггеры:
"Use when user wants to deploy to production""Use when code review is needed before commit""Use when database migration is required""Use when creating a new PR with tests""Use when backup of database is needed"
Чем конкретнее — тем точнее сработает автозагрузка.
3. Поле tools — ограничение инструментов
Ограничьте скилл только нужными инструментами — безопасность и фокус:
[Terminal, Git]— только деплой/гит[Terminal, Git, HTTP, SQL]— деплой + БД + API[Browser, Terminal]— веб-скрейпинг + команды[Filesystem, Terminal, Git]— работа с файлами и гит
4. Готовые примеры скиллов (скопируйте и адаптируйте)
🚀 Deploy Skill — полный пайплайн деплоя
# ~/.config/openclaw/skills/deploy.md
---
name: deploy
description: "Use when user wants to deploy to production. Runs full pipeline with rollback."
tools: [Terminal, Git, HTTP]
---
Deploy procedure:
1. Run tests: npm run test
2. Build: npm run build
3. Check bundle size: npm run analyze
4. Create GitHub release: gh release create
5. Deploy: npm run deploy
6. Verify health: curl https://myapp.com/health
7. Notify Telegram: "✅ Deploy v{version} done!"
Rollback on failure:
- git revert HEAD
- npm run deploy
- Notify: "🔄 Rollback done"
Error handling:
- If tests fail → stop, notify "❌ Tests failed"
- If build fails → stop, notify "❌ Build failed"
- If health check fails → auto rollback
👀 Code Review Skill — ревью перед коммитом
# ~/.config/openclaw/skills/code-review.md
---
name: code-review
description: "Use when code review is needed before commit. Checks bugs, style, security."
tools: [Read, Grep, Glob, Bash]
---
You are a senior code reviewer. Focus on:
1. Security (SQLi, XSS, path traversal, secrets)
2. Performance (N+1, unnecessary re-renders, memory leaks)
3. Code style consistency (ESLint, Prettier)
4. Test coverage gaps (unit, integration, e2e)
5. Error handling (try/catch, Result types)
6. Documentation (JSDoc, README updates)
Output format:
- **Critical**: must fix before merge
- **Warning**: should fix
- **Nitpick**: optional improvement
- **Praise**: good patterns noticed
🗄️ DB Migration Skill — безопасные миграции
# ~/.config/openclaw/skills/db-migration.md
---
name: db-migration
description: "Use when database migration is needed. Creates safe migration with rollback."
tools: [Terminal, SQL, Git]
---
Migration procedure:
1. Analyze current schema: pg_dump --schema-only
2. Create migration file: timestamp_name.sql
3. Write UP migration (changes)
4. Write DOWN migration (rollback)
5. Test on staging: psql -f migration.sql
6. Create PR with migration
7. After merge → run on prod
8. Verify: SELECT * FROM new_table LIMIT 1
Rollback: psql -f migration_down.sql
Notify team: "Migration {name} applied/rolled back"
🔀 PR Creation Skill — авто-создание PR с тестами
# ~/.config/openclaw/skills/pr-create.md
---
name: pr-create
description: "Use when creating a new PR. Runs tests, creates PR with description."
tools: [Terminal, Git, HTTP]
---
PR creation procedure:
1. Run full test suite: npm run test
2. Run lint: npm run lint
3. Run typecheck: npm run typecheck
4. Generate conventional commit message
5. Commit: git commit -m "feat: {description}"
6. Push branch: git push origin {branch}
7. Create PR: gh pr create --title "{title}" --body "{template}"
8. Add reviewers: gh pr edit --add-reviewer @team
9. Wait for CI: gh pr checks --watch
10. Notify: "PR #{number} created: {url}"
💾 Backup Skill — бэкап БД и файлов
# ~/.config/openclaw/skills/backup.md
---
name: backup
description: "Use when backup of database and files is needed. Stores to S3/local."
tools: [Terminal, SQL, HTTP]
---
Backup procedure:
1. DB dump: pg_dump -Fc db_name > backup_$(date +%Y%m%d).dump
2. Compress: gzip backup_*.dump
3. Upload to S3: aws s3 cp backup_*.dump.gz s3://my-bucket/backups/
4. Verify: aws s3 ls s3://my-bucket/backups/ | grep backup_$(date +%Y%m%d)
5. Cleanup local: rm backup_*.dump.gz
6. Prune old: aws s3api delete-objects --bucket my-bucket --delete "$(aws s3api list-object-versions --bucket my-bucket --prefix backups/ --query 'Versions[?LastModified<=`date -d "-30 days" +%Y-%m-%d`].{Key:Key,VersionId:VersionId}')"
7. Notify: "✅ Backup completed: {size} MB"
Restore: pg_restore -d db_name backup_file.dump
5. Где хранить скиллы
- Глобальные (для всех проектов):
~/.config/openclaw/skills/ - Проектные (только в этом репо):
.openclaw/skills/в корне проекта
Омар проверяет обе папки, проектные имеют приоритет.
6. Использование
- Авто: Омар сам загрузит скилл если
descriptionматчит запрос - Ручное:
/skill deployили/skill code-review - С аргументами:
/skill deploy --env staging(если скилл поддерживает args)
7. Отладка скиллов
openclaw skills list— список загруженных скилловopenclaw skills show deploy— содержимое скиллаopenclaw logs --skill deploy— логи выполнения скиллаopenclaw skills validate— проверка синтаксиса всех скиллов
8. Лучшие практики
- Один скилл = одна атомарная задача
- Всегда пишите rollback-процедуру
- Тестируйте на staging перед продакшеном
- Используйте конкретные description для точной автозагрузки
- Ограничивайте tools минимумом необходимого
- Версионируйте скиллы в git (папка .openclaw/skills/ в репо)
Ссылки: Примеры скиллов в репо | Документация по скиллам | Discord #skills
