Скиллы (Skills) — одна из самых мощных функций Claude Code. Это переиспользуемые наборы инструкций, которые учат AI работать с конкретным стеком, фреймворком или задачей. Вместо того чтобы каждый раз объяснять Claude как писать Telegram-бота или как настраивать Docker, вы создаёте скилл один раз и используете его в любом проекте.
Зачем нужны скиллы
Без скиллов каждая сессия начинается с нуля. Вы тратите 10-15 минут на объяснение контекста, паттернов, API конкретной библиотеки. Со скиллом Claude Code сразу знает: используй aiogram 3.x с Router-паттерном, FSM через Redis, middleware для логирования. Экономия времени — в разы.
Вторая причина — консистентность. Скилл фиксирует лучшие практики и паттерны. Без него AI может каждый раз генерировать код по-разному. Со скиллом — всегда одинаковая, проверенная архитектура.
Структура скилла
Скилл — это папка в .claude/skills/ с файлом SKILL.md внутри. SKILL.md содержит frontmatter (name, description) и инструкции для Claude. Опционально — папка references/ для дополнительных файлов: шаблонов, примеров кода, конфигов.
Минимальный скилл: SKILL.md с описанием что делать и 2-3 примерами. Продвинутый скилл: SKILL.md + references/ с шаблонами, чеклистами, рубриками оценки качества.
Как создать скилл
Шаг 1: Определите область
Скилл должен решать конкретную задачу: создание Telegram-бота, написание REST API, настройка Docker Compose, code review. Слишком широкий скилл ("веб-разработка") — бесполезен. Слишком узкий ("кнопка в хедере") — не оправдывает усилий.
Шаг 2: Напишите SKILL.md
Начните с frontmatter: name (короткое имя) и description (одно предложение, которое мотивирует использовать скилл). Затем основная часть: пошаговый workflow, конкретные примеры ввода и вывода, правила и ограничения.
Шаг 3: Добавьте примеры
Минимум 2 конкретных примера. Не абстрактные описания, а реальный код или шаблоны.
Шаг 4: Тестируйте
Создайте 2-3 тестовых промпта и прогоните через скилл. Проверьте: даёт ли скилл достаточно информации для качественного ответа?
Примеры скиллов
aiogram-bot — Telegram-бот на aiogram v3
Содержит: паттерн Router-based архитектуры, шаблоны хендлеров, FSM-состояния, middleware для логирования и rate limiting, интеграция с PostgreSQL через asyncpg.
tdd — Test-Driven Development
Содержит: пошаговый workflow RED → GREEN → REFACTOR, шаблоны тестов для pytest/vitest, правила именования тестов, чеклист coverage.
code-review — Ревью кода
Содержит: чеклист проверки (DRY, KISS, безопасность, типизация), формат отчёта (critical/major/minor), примеры хорошего и плохого кода.
Советы по созданию скиллов
Держите SKILL.md до 500 строк. Больше — выносите детали в references/. Добавьте секцию "Приоритет при конфликтах". Используйте framework-подход: RICE, MoSCoW, SMART.
На Stackovervibe мы собираем каталог готовых скиллов для вайбкодинга. Вы можете скачать .md файл любого скилла и закинуть в свой .claude/skills/ — работает сразу.