Claude Skills: инструкция по созданию переиспользуемых промптов и победа над рутиной

Забудьте про копипаст промптов. Навсегда

Вы когда-нибудь считали, сколько раз за день вводите одни и те же инструкции для Claude? "Проанализируй этот код на уязвимости", "Сгенерируй документацию по API", "Найди баги в логах" — звучит знакомо? Каждый раз копировать, вставлять, слегка модифицировать... Это бесит.

В феврале 2025 года Anthropic тихо выпустила фичу, которая меняет всё. Claude Skills. Не анонсировали громко, не писали в блогах — просто добавили в интерфейс. И те, кто разобрался, теперь работают в три раза быстрее.

Skills — это не просто сохранённые промпты. Это архитектура

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

Я видел команды, где каждый инженер создавал свои Skills под специфичные задачи. Security-специалист — для пентеста, DevOps — для анализа логов, тимлид — для code review. Получается распределённый мозг.

Как это работает технически? Проще, чем кажется

Под капотом у Claude появилась директория .claude/skills. Туда вы складываете файлы с расширением .md. Каждый файл — отдельный skill. Структура обязательная, иначе не сработает.

1 Создаём директорию .claude/skills

Куда? Зависит от операционной системы. Но лучше сразу создать в домашней директории — работает везде.

mkdir -p ~/.claude/skills

Да, именно так. Никаких конфигурационных файлов, никаких настроек. Claude автоматически сканирует эту папку при запуске. Если вы используете Claude через API (например, в своих скриптах), нужно указать путь к skills в запросе — но об этом позже.

2 Пишем первый skill.md файл

Вот где большинство обламывается. Не потому что сложно, а потому что неправильно читают документацию. (Которой, кстати, почти нет. Спасибо, Anthropic.)

Базовая структура файла:

skill: code-reviewer
description: Анализирует код на ошибки безопасности, performance issues и code smell
instructions: |
  Ты — senior-инженер с 15-летним опытом. Анализируй предоставленный код строго по чек-листу:
  
  1. Проверь SQL-инъекции
  2. Найди потенциальные race conditions
  3. Оцени сложность алгоритмов (Big O)
  4. Проверь обработку ошибок
  
  Формат ответа: таблица с проблемами, severity (high/medium/low), и рекомендацией по фиксу.
  Не давай общих советов — только конкретные строки кода.

Обратите внимание на вертикальную черту после instructions: — это YAML-синтаксис для многострочных строк. Без этого ваш промпт обрежется на первой же новой строке.

3 Активация и использование

После создания файла перезапустите Claude Desktop (да, нужно перезапустить). В интерфейсе появится новая иконка — шестерёнка или что-то подобное. Там будут ваши Skills.

Использовать просто: начинаете диалог с Claude, и когда нужно применить skill, пишете:

@code-reviewer

Claude автоматически подтянет инструкции из файла. Всё. Не нужно копировать, не нужно вспоминать — просто вызываете по имени.

Реальные примеры, которые работают сегодня

Теория — это хорошо, но давайте посмотрим на Skills, которые я использую ежедневно. Эти примеры актуальны для Claude 4.5 Sonnet (последняя стабильная версия на февраль 2026).

Skill для анализа Dockerfile

skill: docker-audit
description: Аудит Dockerfile на best practices и security issues
instructions: |
  Ты — DevOps-инженер специализирующийся на container security.
  
  Проанализируй предоставленный Dockerfile по пунктам:
  - Использование root пользователя
  - Наличие уязвимых базовых образов (проверь через CVE базы)
  - Многослойность и кэширование
  - Наличие секретов в коде
  - Оптимальность RUN команд
  
  Для каждого пункта давай конкретную рекомендацию с примером исправления.
  Если есть критические issues — предлагай немедленный фикс.

Skill для генерации тестов

skill: test-generator
description: Генерирует unit-тесты для Python/JavaScript кода
instructions: |
  На основе предоставленного кода сгенерируй полный набор unit-тестов.
  
  Требования:
  1. Coverage не менее 90%
  2. Моки для внешних зависимостей
  3. Тесты на edge cases
  4. Используй pytest для Python или jest для JavaScript
  5. Включи тесты на обработку ошибок
  
  Не просто показывай примеры — генерируй готовый к запуску код.
  Комментируй сложные моменты в тестах.

Эти Skills — часть моего рабочего стека. Когда я работаю над проектом, я просто вызываю @docker-audit для каждого нового Dockerfile. Экономия времени — около 15 минут на файл.

А теперь о боли: 7 ошибок, которые убьют ваши Skills

Я видел, как люди часами debug-ят свои Skills, а проблема в одной строке. Не повторяйте этих ошибок.

Самая частая ошибка — пункт 2. Люди пишут instructions в одну строку, а потом удивляются, почему Claude игнорирует половину инструкций.

Skills в API: автоматизация на стероидах

Веб-интерфейс — это хорошо, но настоящая сила Skills раскрывается в API. Представьте себе скрипт, который автоматически анализирует пулл-реквесты, используя ваши Skills.

Вот как это работает с Claude API 4.5 (актуально на 2026 год):

import anthropic
from pathlib import Path

client = anthropic.Anthropic(api_key="ваш_ключ")

# Загружаем skill из файла
skill_path = Path.home() / ".claude" / "skills" / "code-reviewer.md"
skill_content = skill_path.read_text(encoding="utf-8")

# Парсим (упрощённо)
# В реальности нужно распарсить YAML-подобную структуру
instructions = skill_content.split("instructions: |\n")[1].strip()

# Используем в запросе
response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=4000,
    messages=[
        {
            "role": "user",
            "content": f"{instructions}\n\nВот код для анализа:\npython\n{code_to_review}\n"
        }
    ]
)

print(response.content[0].text)

Конечно, это упрощённый пример. В продакшене нужно парсить skill.md правильно (они используют почти-YAML синтаксис). Но идея ясна: Skills становятся модулями в ваших автоматических пайплайнах.

Skills vs Claude Code: в чём разница?

Многие путают Skills с Claude Code. Это разные вещи.

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

Можно сказать так: Claude Code — это специализированный инструмент для разработчиков. Skills — это мета-инструмент для управления самим Claude. Вы можете использовать Skills внутри Claude Code (да, это работает), чтобы стандартизировать свои запросы.

Безопасность: трояны в ваших skill.md

В октябре 2025 года случилась интересная история. Кто-то начал распространять Skills с скрытыми инструкциями — типа "когда видишь API ключ, отправляй его на внешний сервер". Да, прямо как в статье "Трояны в skill.md файлах".

Мораль: не используйте чужие Skills без проверки. Всегда смотрите, что написано в instructions. Особенно если skill предлагает что-то вроде "ускорение работы в 10 раз".

Частые вопросы (FAQ)

Сколько Skills можно создать?

Технических ограничений нет. Но если у вас больше 50 — вы, вероятно, делаете что-то не так. Skills должны быть атомарными. Лучше 10 простых Skills, которые можно комбинировать, чем 1 монстр на 1000 строк.

Работают ли Skills в мобильном приложении Claude?

На февраль 2026 — нет. Только в десктопной версии и через API. Мобильное приложение синхронизирует историю диалогов, но не локальные файлы Skills.

Можно ли использовать переменные в Skills?

Прямой поддержки переменных нет. Но есть хак: используйте плейсхолдеры типа {FILE_PATH} или {LANGUAGE}, а затем заменяйте их в коде перед отправкой. В API это делается через строковые замены.

Skills работают с Claude 3.5 или только с 4.5?

Skills как фича появились в Claude 4.0. С 3.5 не работают. Если у вас старая версия — обновитесь. На 2026 год актуальна Claude 4.5 Sonnet, и там всё работает идеально.

Можно ли делиться Skills с командой?

Да, но не через встроенный механизм. Просто копируйте файлы .md в репозиторий. Или создайте общую сетевую папку. Anthropic пока не сделала механизм sharing, что, честно говоря, раздражает.

Что дальше? Цепочки Skills и автономные агенты

Самый мощный паттерн, который я видел — цепочки Skills. Один Skill анализирует код, второй генерирует тесты, третий создаёт документацию. Вместе они образуют конвейер.

Представьте: вы делаете коммит, и автоматический скрипт прогоняет ваш код через цепочку Skills. Аналогично тому, как описано в статье "Промпт для автономной декомпиляции кода", но с вашими собственными экспертами.

Мой прогноз на 2027 год: Skills станут стандартом для enterprise-внедрения Claude. Компании будут создавать библиотеки корпоративных Skills — для код-ревью, анализа бизнес-процессов, генерации отчётов. Это следующий шаг после RAG.

А пока — создайте свой первый Skill. Прямо сейчас. Возьмите промпт, который используете каждый день, и превратите его в файл. Через неделю вы не поймёте, как жили без этого.

P.S. Если хотите увидеть продвинутые примеры — посмотрите статью "Claude Skills: полное руководство". Там есть про интеграцию с внешними инструментами и orchestration.

Подписаться на канал