Что такое Skills в Claude Code: slash-команды для ускорения работы

Что такое Skills

Skills (навыки) — это пользовательские slash-команды для Claude Code. Они позволяют сохранить часто используемые промпты как команды и вызывать их через /имя.

Представьте: вы каждый день просите Claude Code провести код-ревью, написать тесты или сгенерировать коммит-сообщение. Каждый раз вы формулируете запрос заново, стараясь не забыть важные детали. Skills решают эту проблему — вы один раз описываете идеальный промпт, сохраняете его в файл, и дальше вызываете одной командой.

По сути, Skills — это макросы или сниппеты, но для AI-агента. Вместо того чтобы автоматизировать нажатия клавиш, вы автоматизируете инструкции для ИИ.

Как работают Skills

При вызове /skill-name Claude Code находит соответствующий .md файл, загружает его содержимое как промпт и выполняет инструкцию. Весь текст из файла становится контекстом для агента.

Skills могут принимать аргументы — например, путь к файлу или название модуля. Это делает их гибкими: одна команда покрывает множество сценариев.

Механизм работы прост:

1. Вы вводите /review в Claude Code
2. Claude Code ищет файл review.md в директориях Skills
3. Содержимое файла загружается как инструкция
4. Агент выполняет промпт в контексте вашего проекта

Где хранятся Skills

Skills хранятся на трёх уровнях, от персональных до внешних.

Персональные Skills

Путь: ~/.claude/commands/

Доступны во всех ваших проектах. Это ваши личные команды — код-ревью в вашем стиле, привычный формат коммитов, персональные шаблоны. Они не попадают в git и остаются только на вашей машине.

Проектные Skills

Путь: .claude/commands/ в корне проекта

Доступны всем участникам проекта. Коммитятся в git, поэтому вся команда использует одинаковые промпты. Это особенно полезно для стандартизации процессов: единый формат ревью, общие правила генерации тестов, согласованный стиль документации.

Skills от MCP-серверов

Предоставляются подключёнными MCP-серверами. Появляются автоматически при подключении сервера и расширяют возможности агента инструментами из внешних сервисов.

Как создать Skill

Создание Skill занимает минуту. Разберём на примере команды для код-ревью.

Шаг 1. Создайте файл

Для персонального Skill:

mkdir -p ~/.claude/commands
touch ~/.claude/commands/review.md

Для проектного Skill:

mkdir -p .claude/commands
touch .claude/commands/review.md

Шаг 2. Напишите промпт-инструкцию

Откройте файл review.md и добавьте содержимое:

Проведи код-ревью последних изменений в git.
Проверь:
- Безопасность (SQL injection, XSS, hardcoded secrets)
- Производительность (N+1 queries, unnecessary allocations)
- Стиль кода (naming, structure)
Выведи результат в формате: файл, строка, проблема, рекомендация.

Шаг 3. Вызовите в Claude Code

/review

Claude Code загрузит промпт из файла, проанализирует git diff и выдаст структурированный отчёт.

Аргументы в Skills

Skills поддерживают специальную переменную $ARGUMENTS, которая подставляет всё, что вы введёте после имени команды.

Пример файла explain.md:

Объясни файл $ARGUMENTS подробно:
- Что делает каждая функция
- Как связаны компоненты
- Какие паттерны используются

Вызов:

/explain src/proxy/handlers.rs

В этом случае $ARGUMENTS заменится на src/proxy/handlers.rs, и Claude Code подробно разберёт указанный файл.

Примеры полезных Skills

/commit — генерация commit message и коммит

Файл commit.md:

Посмотри staged изменения через git diff --cached.
Сгенерируй осмысленный commit message на английском языке:
- Первая строка: тип(скоуп): краткое описание (до 72 символов)
- Типы: feat, fix, refactor, docs, test, chore
- Если изменений много, добавь тело коммита с деталями
Создай коммит с этим сообщением.

/review — код-ревью с фокусом на безопасность

Файл review.md:

Проведи код-ревью последних изменений в git.
Проверь:
- Безопасность (SQL injection, XSS, hardcoded secrets)
- Производительность (N+1 queries, unnecessary allocations)
- Стиль кода (naming, structure)
Выведи результат в формате: файл, строка, проблема, рекомендация.

/test — генерация тестов для указанного файла

Файл test.md:

Сгенерируй тесты для файла $ARGUMENTS.
Требования:
- Покрой основные сценарии (happy path)
- Добавь edge cases (пустые значения, невалидный ввод, граничные условия)
- Используй существующий тестовый фреймворк проекта
- Следуй паттернам из уже существующих тестов
Запусти тесты и убедись, что они проходят.

/refactor — рефакторинг с объяснением

Файл refactor.md:

Проведи рефакторинг файла $ARGUMENTS.
Направления:
- Устрани дублирование кода
- Улучши именование переменных и функций
- Разбей длинные функции на компактные
- Примени подходящие паттерны проектирования
После каждого изменения объясни, что именно улучшилось и почему.
Убедись, что тесты проходят после рефакторинга.

/explain — подробное объяснение кода

Файл explain.md:

Объясни файл $ARGUMENTS подробно:
- Что делает каждая функция
- Как связаны компоненты
- Какие паттерны используются
- Какие зависимости и почему
Если есть неочевидные решения, объясни их мотивацию.

/fix-ci — анализ и исправление упавшего CI

Файл fix-ci.md:

CI pipeline упал. Проанализируй ситуацию:
1. Посмотри последние изменения через git log и git diff
2. Запусти тесты локально и найди падающие
3. Определи причину: сломанный тест, ошибка компиляции, линтер
4. Исправь проблему
5. Убедись, что все тесты проходят
6. Опиши, что было сломано и как исправлено

/doc — генерация документации

Файл doc.md:

Сгенерируй документацию для модуля $ARGUMENTS.
Формат:
- Краткое описание назначения модуля
- Публичный API: каждая функция/метод с параметрами и возвращаемым значением
- Примеры использования
- Зависимости и связи с другими модулями
Используй формат документации, принятый в проекте.

Skills от MCP-серверов

Некоторые MCP-серверы предоставляют собственные Skills. При подключении сервера его команды автоматически появляются в списке доступных slash-команд.

Например, MCP-сервер для работы с базой данных может предоставить Skill /query для выполнения SQL-запросов, а сервер для Jira — Skill /ticket для создания задач прямо из Claude Code.

Это позволяет строить мощные рабочие процессы: анализировать код, создавать задачи в трекере и обновлять документацию — всё через slash-команды, не покидая терминал.

Советы по работе со Skills

Делайте Skills конкретными, а не универсальными. Skill “сделай что-нибудь полезное с кодом” бесполезен. Skill “проведи ревью безопасности по OWASP Top 10” — работает. Чем точнее инструкция, тем лучше результат.

Добавляйте проектные Skills в git. Вся команда будет использовать одинаковые промпты. Это стандартизирует процессы: новый разработчик получает готовые команды сразу после клонирования репозитория.

Используйте $ARGUMENTS для гибкости. Один Skill с аргументом заменяет десяток специализированных. /test src/auth.rs и /test src/proxy/server.rs — одна команда, разные файлы.

Комбинируйте Skills с MCP-серверами. MCP-серверы дают доступ к внешним сервисам, а Skills задают алгоритм работы. Вместе они создают полноценные автоматизированные рабочие процессы.

Итерируйте промпты. Если Skill выдаёт не то, что нужно, уточните инструкцию. Добавьте конкретный формат вывода, укажите, на что обращать внимание, задайте ограничения. Хороший промпт — результат нескольких итераций.

Итог

Skills превращают повторяющиеся задачи в одну команду. Вместо того чтобы каждый раз формулировать запрос заново, вы вызываете /review, /test или /commit — и получаете стабильный, предсказуемый результат.

Для команды это ещё ценнее: проектные Skills в git гарантируют, что все участники работают по одним стандартам.

Начать работу ->