Настройка скиллов Claude: как устроен SKILL.md и где хранить скиллы

Обновлено 6 минут чтения

Скилл (в запросах пишут и «скилл», и «скил») — это папка с файлом 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 не использует скилл:

  1. Проверь, что в описании есть слова, которые пользователь произносит естественно.
  2. Спроси Claude «What skills are available?» и посмотри, есть ли скилл в списке.
  3. Переформулируй запрос ближе к описанию.
  4. Вызови скилл напрямую через /имя.

Если заголовок YAML записан с ошибкой, скилл загружается без метаданных: команда /имя работает, но Claude не может сопоставить задачу с описанием. Запусти Claude Code с флагом --debug, чтобы увидеть ошибку разбора.

Когда скилл срабатывает слишком часто, сделай описание точнее или добавь disable-model-invocation: true.

Правки подхватываются без перезапуска: Claude Code следит за папками скиллов и применяет изменения в текущей сессии. Если ты создал верхнюю папку скиллов, которой не было при запуске, выполни /reload-skills.

5 скиллов для маркетолога

В каталоге есть готовые скиллы для маркетинговых задач. С этих пяти я бы начал.

Всего в каталоге 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 не запускается. Отправьте себе ссылку на этот список.

  1. Контент
    Копирайтинг

    Для маркетологов: пишет убедительные продающие тексты для конверсии.

    copywriting · coreyhaines31

  2. Контент
    Стратегия контента

    Для маркетологов: планирует контент, который ранжируется и вовлекает

    content-strategy · coreyhaines31

  3. Контент
    Контент-менеджер

    Для маркетологов: создаёт вовлекающий контент для соцсетей с учётом аудитории и платформ

    social-content · coreyhaines31

Что нужно: компьютер и Claude Code — он работает с подпиской Claude Pro и выше, на бесплатном плане его нет. Как поставить Claude Code →

Читать дальше