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