раздел 05

Skills - переиспользуемые процессы

Skill - это упакованный многошаговый процесс, который запускается одной командой. Если вы хоть раз говорили Claude "сделай ревью PR: сначала проверь безопасность, потом стиль, потом тесты, в конце дай вердикт" - вы готовый кандидат на skill.

Зачем

В обычной работе вы держите процессы в голове или в Notion. Через месяц забываете шаги, новый разработчик в команде делает по-своему, результат расходится. Skill превращает процесс в один файл - и его выполняет Claude по тому же чек-листу каждый раз.

Анатомия skill

Skill - это обычный Markdown-файл с frontmatter. Лежит в ~/.claude/skills/<name>/SKILL.md (глобально) или .claude/skills/<name>/SKILL.md (в проекте).

---
name: deploy
description: |
  Деплоит текущую ветку на прод через git push + docker-compose.
  Использовать когда: пользователь сказал "задеплой", "выкатить", "выложить на прод".
  НЕ использовать для staging - там отдельный skill `/deploy-staging`.
tools:
  - Bash
  - Read
---

# Deploy skill

## Шаги

1. Проверь `git status` - нет ли незакоммиченных файлов. Если есть - стоп.
2. Запусти локальные тесты: `pytest && pnpm test`. Если падают - стоп.
3. `git push origin main`
4. SSH на прод: `ssh selectel "cd /opt/app && git pull && docker compose up -d --build"`
5. Дождись запуска контейнера, проверь `docker compose ps`
6. Запусти smoke-тесты: `python test/smoke.py https://app.example.com`
7. Если всё ОК - отправь уведомление в Telegram

## Что делать при ошибке

Если шаг 6 (smoke) упал - откатиться: `git revert HEAD && git push`.

После создания файла Claude в любой сессии понимает: "пользователь говорит 'задеплой' - запускаю skill /deploy".

Встроенные skills - то, что уже работает из коробки

Anthropic поставляет десятки готовых skills вместе с Claude Code:

  • /init - сгенерировать CLAUDE.md для текущего проекта
  • /review - ревью текущих изменений на ошибки
  • /security-review - security-аудит pending changes
  • /verify - запустить приложение и убедиться, что фича реально работает
  • /run - запустить приложение в нужном режиме (CLI, server, browser)
  • /code-review, /loop, /schedule, /deep-research - и ещё десятки

Полный список - claude -> /help -> внизу список skills.

Что в этом разделе

01
Анатомия skill: SKILL.md и frontmatter
name, description, triggers. Как Claude понимает, когда подключить skill.
02
Создаём свой skill за 10 минут
Пример: skill blog-post-writer - пишет посты в вашем стиле.
03
Встроенные skills
/init, /review, /security-review, /verify, /run - что они делают и когда дёргать.
04
Готовые skills для копипаста
deploy, pr-review, changelog, smoke-tests - забираем целиком.

Полезные ссылки