Настройка скиллов Claude: как устроен SKILL.md и где хранить скиллы
Скилл (в запросах пишут и «скилл», и «скил») — это папка с файлом SKILL.md, в котором ты один раз записываешь инструкцию для Claude: как писать посты, как проверять код, как делать аудит. Настройка скилла сводится к трём вещам: положить папку в нужное место, написать SKILL.md с понятным описанием и проверить, что Claude вызывает скилл на нужных задачах. Всё это разобрано ниже.
Здесь только про скиллы. О файле CLAUDE.md, который Claude Code читает в каждой сессии, рассказано в статье «CLAUDE.md (claude md): что это и пример файла», а как поставить готовый скилл из каталога, смотри в инструкции для начинающих.
Что такое скилл и чем он отличается от CLAUDE.md
Claude Code сначала видит только имя и описание скилла, а полный текст инструкции загружает, когда скилл используется. Это описано в документации Claude Code (откроется в новой вкладке). Поэтому в скилл удобно класть длинные инструкции: пока они не нужны, они почти не занимают контекст.
В CLAUDE.md лежит то, что Claude должен знать в каждой сессии: команды сборки, соглашения проекта. По документации, если запись в CLAUDE.md разрослась до многошаговой процедуры, её стоит перенести в скилл. Скилл пригодится, когда ты уже не раз вставлял в чат один и тот же порядок действий.
Технически скилл может содержать:
- тон голоса и стоп-слова;
- структуру выходного текста;
- примеры хорошего и плохого результата;
- чеклисты, которые Claude проверяет сам.
Один скилл решает одну задачу: посты для соцсетей отдельно, SEO-аудит отдельно.
Где лежит скилл: папки и пути
Где ты сохранишь скилл, от этого зависит, в каких сессиях он загрузится.
- Личный:
~/.claude/skills/<имя>/SKILL.md. Работает во всех твоих проектах на этом компьютере. - Проект:
.claude/skills/<имя>/SKILL.md. Работает в сессиях этого репозитория; закоммить папку, и скилл получит вся команда. - Плагин:
<плагин>/skills/<имя>/SKILL.md. Работает везде, где плагин включён; команда имеет вид/плагин:имя. - Аккаунт claude.ai: включается в настройках аккаунта. Работает в сессиях Cowork, облачных сессиях и терминале с входом под этим аккаунтом.
Для проекта структура выглядит так: у каждого скилла своя папка, внутри неё файл SKILL.md.
.claude/skills/
├── copywriting/
│ └── SKILL.md
└── email-sequence/
└── SKILL.md
Личные скиллы из ~/.claude/skills/ не видны в Cowork и облачных сессиях: там нужно включить скилл в настройках аккаунта claude.ai или закоммитить его в репозиторий.
Из чего состоит SKILL.md
Файл делится на две части: YAML-заголовок между строками --- и инструкции в Markdown. В заголовке по документации все поля необязательные, но рекомендуется description: по нему Claude решает, когда применять скилл. Если name не указан, команда берётся из имени папки. Заголовок читается, только если первая строка файла — ---.
Пример скилла, который я бы положил в личную папку:
---
name: telegram-post
description: Пишет пост для Telegram-канала компании. Используй, когда просят написать пост, анонс или апдейт для канала.
---
# Пост для Telegram
1. Если не сказано, о чём пост и для кого, сначала спроси.
2. Пиши на «ты», 80–100 слов, без эмодзи.
3. Не используй слова «инновационный», «уникальный», «передовой».
4. Закончи пост одним вопросом к читателю.
Этот пример мой, в документации такого скилла нет. Сохрани его как ~/.claude/skills/telegram-post/SKILL.md, и он станет доступен в каждом проекте.
Как написать description, чтобы скилл срабатывал
Описание отвечает на два вопроса: что скилл делает и когда его применять. Документация советует ставить главный сценарий в начало: общий текст description и when_to_use обрезается в списке скиллов на 1 536 символах.
Если Claude не использует скилл, когда должен, первым делом проверь, что в описании есть слова, которыми ты сам просишь о такой задаче. В примере выше это «пост», «анонс», «апдейт». Описание «Помощник для контента» этих слов не содержит, и Claude труднее понять, что скилл подходит.
Запуск вручную и автоматически
По умолчанию скилл можно вызвать двумя способами: ты набираешь /telegram-post в начале сообщения, или Claude подключает его сам, когда задача подходит к описанию. Два поля в заголовке меняют это:
disable-model-invocation: trueзапрещает Claude подключать скилл самостоятельно, остаётся только ручной вызов. Документация рекомендует это для действий с побочными эффектами вроде/deploy.user-invocable: falseоставляет скилл только для Claude, в меню/он не появится. Так оформляют фоновые знания.
Дополнительные файлы в папке скилла
Рядом с SKILL.md можно положить другие файлы: справочник, примеры, скрипты. Claude обращается к ним, только когда они нужны, а в SKILL.md ты указываешь, что где лежит и когда это читать. Документация советует держать сам SKILL.md короче 500 строк, а подробности выносить в отдельные файлы.
telegram-post/
├── SKILL.md
└── examples.md
Скилл не срабатывает или срабатывает не вовремя
Документация предлагает порядок проверки, если Claude не использует скилл:
- Проверь, что в описании есть слова, которые пользователь произносит естественно.
- Спроси Claude «What skills are available?» и посмотри, есть ли скилл в списке.
- Переформулируй запрос ближе к описанию.
- Вызови скилл напрямую через
/имя.
Если заголовок YAML записан с ошибкой, скилл загружается без метаданных: команда /имя работает, но Claude не может сопоставить задачу с описанием. Запусти Claude Code с флагом --debug, чтобы увидеть ошибку разбора.
Когда скилл срабатывает слишком часто, сделай описание точнее или добавь disable-model-invocation: true.
Правки подхватываются без перезапуска: Claude Code следит за папками скиллов и применяет изменения в текущей сессии. Если ты создал верхнюю папку скиллов, которой не было при запуске, выполни /reload-skills.
5 скиллов для маркетолога
В каталоге есть готовые скиллы для маркетинговых задач. С этих пяти я бы начал.
- Копирайтинг: пишет продающие тексты для конверсии.
- Стратегия контента: планирует контент.
- Контент-менеджер: создаёт контент для соцсетей с учётом аудитории и платформ.
- Последовательность писем: собирает email-цепочки.
- Создатель скиллов: помогает написать свой скилл с верной структурой, если готовых мало.
Всего в каталоге claudeskills.ru больше ста скиллов. Если нужно сначала понять, как писать сами инструкции для Claude, начни со статьи «Промпты для Claude на русском».
Частые вопросы
Claude Skills работают только в Claude Code?
Нет. Скиллы доступны и в Claude Code, и в Claude на сайте. По справке Anthropic (откроется в новой вкладке), для работы с ними в Claude нужно включить выполнение кода. На сайте свой скилл загружают ZIP-файлом и включают в Customize → Skills по инструкции Anthropic (откроется в новой вкладке). В этом гайде разобраны папки скиллов для Claude Code.
Скиллы бесплатные?
Да. Все скиллы в каталоге на claudeskills.ru бесплатные: на странице каждого скилла указан тип «Бесплатно».
Нужно ли знать программирование?
Нет. Основа скилла — текстовый файл SKILL.md в формате Markdown. Если ты умеешь писать заметки с заголовками и списками, ты справишься со скиллом. Установка — копирование папки скилла с файлом SKILL.md в .claude/skills/; подробнее в инструкции для начинающих.
Сколько скиллов можно поставить одновременно?
Выбирай скиллы под свои задачи. Claude Code использует описания, чтобы выбрать подходящие инструкции, и загружает полный текст при использовании скилла, а не читает все SKILL.md перед каждым запросом. Начни с нескольких скиллов и проверь, что каждый вызывается на нужной задаче.
Скиллы заменят маркетолога?
Нет. Скилл — это инструмент, не замена человека. Claude хорошо генерирует черновики, структуру, идеи. Но стратегию, позиционирование и финальное редактирование делаешь ты. Скиллы убирают рутину, а не экспертизу.
Что поставить первым
Скиллы ставятся на компьютере, на телефоне Claude Code не запускается. Отправьте себе ссылку на этот список.
- КонтентКопирайтинг
Для маркетологов: пишет убедительные продающие тексты для конверсии.
copywriting· coreyhaines31 - КонтентСтратегия контента
Для маркетологов: планирует контент, который ранжируется и вовлекает
content-strategy· coreyhaines31 - КонтентКонтент-менеджер
Для маркетологов: создаёт вовлекающий контент для соцсетей с учётом аудитории и платформ
social-content· coreyhaines31
Читать дальше
- Лучшие скиллы для Claude Code: топ-15 по скачиваниям с примерамиТоп-15 скиллов для Claude Code по скачиваниям за 90 дней: что делает каждый, пример запроса и команда установки. Код, тесты, ревью, планы.
- Скачать Claude на компьютер и телефон: Windows, Mac, iOS, AndroidСкачать Claude Desktop для Windows, macOS, Linux, iPhone и Android: официальные ссылки, требования, как не попасть на подделку, что с регионом.
- Claude для программирования: чат, Claude Code, IDE и API — какой способ выбратьКак программировать с Claude: чат для быстрых вопросов, Claude Code для проекта, расширения IDE и API. Что выбрать под задачу и какие скиллы подключить.