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

1 файлминимум для рабочего скилла
3 скиллакомфортный лимит в одном проекте
5 минутна сборку простого скилла
0 ₽доплата за скиллы сверх подписки

Схема: папка скилла с SKILL.md подключается к диалогу Claude Code по описанию задачи

Что такое Claude Code Skills и чем они отличаются от промпта

Промпт живёт один раз — ты его написала, Claude ответил, и всё исчезло в истории чата. Скилл — это промпт, который сохранили в файл и научили агента находить самостоятельно.

Технически скилл — папка с обязательным файлом SKILL.md: в frontmatter — имя и короткое description (по нему Claude решает, вызывать скилл или нет), в теле — сама инструкция обычным человеческим языком. Рядом можно положить что угодно: скрипты, шаблоны, примеры кода, чек-листы — Claude откроет их только если понадобится.

Разница со старым добрым CLAUDE.md — в масштабе. CLAUDE.md — это память проекта, она грузится в контекст всегда, целиком, при каждом запуске. Если писать туда каждую мелкую инструкцию, файл разрастается, и агент начинает путаться в приоритетах. Мы разбирали это подробно в статье про файл памяти CLAUDE.md — общий принцип оттуда актуален и здесь: то, что нужно не всегда, не должно жить в файле, который читается всегда.

Подробнее про природу скиллов вообще — в нашей первой статье про то, что такое скиллы Claude: там объяснение без привязки конкретно к Claude Code, здесь — уже с прицелом на терминал и реальную работу с кодом.

Как устроен скилл внутри: SKILL.md и progressive disclosure

Внутри всё держится на одном механизме — Anthropic называет его progressive disclosure, постепенное раскрытие. Работает в три уровня:

  1. Метаданные. Claude Code видит только name и description каждого скилла в папке — буквально пару строк. Это стоит копейки контекста, даже если у тебя лежат десятки скиллов.
  2. Тело SKILL.md. Если описание совпало с задачей, Claude разворачивает и читает весь файл — там уже полная инструкция, шаги, примеры.
  3. Файлы рядом. Скрипты, шаблоны, справочники агент открывает по ходу работы, только когда инструкция ссылается на конкретный файл.

Именно поэтому скиллы не раздувают контекст так, как раздувает гигантский CLAUDE.md: Claude платит вниманием только за то, что реально использует.

Скиллы vs MCP vs CLAUDE.md — в чём разница

Три вещи звучат похоже, путают всех новичков одинаково. Вот таблица, которая закрывает вопрос раз и навсегда.

Инструмент Что делает Когда грузится Когда применять
CLAUDE.md Память проекта: стиль, договорённости, контекст Всегда, целиком, при каждом запуске Общие правила проекта, которые нужны в любом диалоге
Skill Инструкция «как делать» + опциональные файлы По необходимости, короткое описание всегда, файл — по запросу Повторяющиеся процессы: ревью кода, генерация отчёта, формат коммита
MCP-сервер Доступ к внешним данным/инструментам (БД, API, файлы) Подключается как отдельный сервис, живёт вне контекста диалога Когда агенту нужны «руки» — доступ к внешней системе

Про MCP отдельно и подробно — в статье MCP-сервер для Claude Code: там разбор, как подключить внешний источник данных, а скиллы и MCP в реальных проектах почти всегда работают в паре — скилл описывает процесс, MCP даёт доступ к тому, с чем этот процесс работает.

Вот тут и начинается разница между «поставила Claude Code» и «умею выстроить систему из скиллов и агентов».

В канале «А.М. решает вопросы» я разбираю живые кейсы с агентами и скиллами — там же лежит пост о том, как мы с Claude собираем сайты и раздаём готовые скиллы, чтобы не изобретать велосипед с нуля.

Забрать разборы в канале

Сравнение: слева хаотичный CLAUDE.md на 2000 строк, справа три узких скилла в отдельных папках

Как установить скилл в Claude Code

Скиллы Claude code устанавливаются в два хода:

  1. Создай (если её нет) папку .Claude/skills/ в корне проекта — это личные скиллы конкретного проекта. Для скиллов, которые нужны во всех твоих проектах, есть глобальная папка настроек Claude Code.
  2. Положи внутрь папку с готовым скиллом — она должна содержать файл SKILL.md. Claude Code подхватывает содержимое .Claude/skills/ при следующем запуске, без переустановки самого Claude Code.

Если ты только настраиваешь Claude Code с нуля, у нас есть отдельный разбор — как установить Claude Code — с шагами от установки до первого запуска. Скиллы кладутся уже поверх готового рабочего инструмента, не раньше.

Скриншот: Репозиторий anthropics/skills на GitHub с примерами готовых скиллов (снято 06.08.2026)
Скриншот: Репозиторий anthropics/skills на GitHub с примерами готовых скиллов (снято 06.08.2026)

Как создать свой первый скилл в Claude Code

Claude code skills как создать — вопрос, который решается одним файлом. Минимальный скилл — это:

---
name: code-review
description: Проверяет диффы кода на соответствие стилю
проекта перед коммитом
---

Когда проверяешь код перед коммитом:
1. Смотри на соответствие соглашениям об именовании из этого
проекта.
2. Проверяй, что нет закомментированного мёртвого кода.
3. Пиши замечания коротко, по пунктам, без вежливых
вступлений.

Дальше можно добавлять файлы рядом — примеры «хорошего» и «плохого» кода, шаблон итогового отчёта, скрипт линтера. Claude сам решит, когда их открыть.

Свой первый скилл я собирала в дороге, в блокноте телефона — и первый час он просто не срабатывал. Оказалось, дело в пустом description: без него Claude Code не понимает, когда скилл вообще предлагать, и молча его игнорирует. Мелочь, а полдня жизни забрала.

Если хочешь готовую методологию сборки скилла с нуля, а не только формат файла — у нас есть отдельная статья Claude skills: что это и как собрать, она разбирает процесс пошагово, независимо от того, в каком интерфейсе Claude ты работаешь.

Где брать готовые скиллы Claude code и чего избегать

Три источника, которые реально стоит смотреть:

  • Официальный репозиторий Anthropic с примерами — там базовые скиллы под типовые задачи, можно смотреть просто как образец структуры файла.
  • Сообщество и подборки — у нас есть отдельная подборка готовых скиллов Claude с разбором, какой скилл под какую задачу брать.
  • Свои прошлые проекты. Самый недооценённый источник — почти каждый регламент, который ты уже писала руками в промптах, можно оформить в скилл за пять минут.

Чего избегать — скиллов с непрозрачным описанием того, что они делают («универсальный помощник для всего»), и скиллов, которые просят выполнить команды с доступом к системе без объяснений зачем.

Итоговая схема: скилл, CLAUDE.md и MCP работают вместе в одном проекте Claude Code

Читайте также

Скиллы решают конкретную задачу — экономят время на повторяющихся процессах. Но собрать из них систему, где агенты сами передают друг другу задачи, а не просто выполняют разовые инструкции, — это уже следующий уровень, и туда одной статьёй не завести. В канале «А.М. решает вопросы» я регулярно показываю, как это выглядит на живых проектах — без причёсанной картинки из презентации, с реальными граблями и тем, что пошло не так. Подписаться и забрать разборы