Skills в Claude Code: как написать свой первый скилл с нуля в 2026

В октябре 2025-го Anthropic выкатил для Claude новую штуку — Skills. На вид это просто папка с markdown-файлом, на деле — способ научить Claude Code работать по вашим правилам, не объясняя их каждый раз заново.

В статье разберём, что такое Skill, чем он отличается от slash-команды, MCP-сервера и файла CLAUDE.md, и соберём вместе первый скилл с нуля — на конкретной задаче. Возьмём анти-AI-фильтр для текстов: после прогона через такой скилл Claude убирает из статьи характерные AI-обороты вроде «в современном мире» и «погрузиться в тему».

Если вы ещё не знакомы с самим Claude Code, начните с обзорной статьи «Что такое Claude Code: тарифы, интерфейс, первый запуск». Там разобран сам инструмент, цены и как поставить его на Mac, Windows и через WSL.

А общую базу про нейросети мы собрали в материале «Что такое нейросети простыми словами» — если AI вы только начинаете осваивать.

Статья пригодится не только разработчикам. Skills сейчас используют редакторы, маркетологи, аналитики, продакты и все, кто работает с Claude Code или Claude Desktop как с рабочей средой. Мы в Checkroi пишем свои скиллы под редакционные задачи: оптимизация статей, генерация Pinterest-пинов, монтаж коротких видео. Часть кода для этой статьи тоже сгенерировал кастомный скилл.

Если хочется освоить AI-инструменты системно, заглядывайте в подборку курсов по нейросетям и искусственному интеллекту: там 316 программ от коротких интенсивов до годовых.

Что такое скилл в Claude Code простыми словамиСкопировано

Skill в Claude Code — это папка с инструкцией, которую Claude читает перед тем, как сделать свой класс задач. Внутри обязательно лежит файл SKILL.md с шапкой и текстом, по желанию — вспомогательные файлы: примеры, шаблоны, скрипты на Python.

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

Аналогия из офисной жизни: представьте, что у вас в команде есть новый работник. Вы каждое утро объясняете ему, как правильно оформить отчёт по продажам. И каждый раз он как-то по-новому решает эту задачу.

На десятый раз вы пишете регламент: «Если приходит задача с продажами — делай по шагам 1, 2, 3». Новичок теперь сам открывает регламент и работает по нему. Skill в Claude Code — такой же регламент, только читает его модель, а не человек.

Главная фишка скиллов — они подгружаются только тогда, когда нужны. Если у вас 50 скиллов на разные задачи, Claude не держит весь их текст в контексте постоянно. Он видит только описания в шапке, а тело подгружает на лету. Это сильно экономит контекст и деньги.

В Claude Code скиллы поддерживаются официально с конца 2025 года, и то же самое работает в Claude Desktop и через Anthropic API. Стандарт открытый, называется Agent Skills, его уже поддерживают несколько других AI-инструментов.

Skill, slash-команда, MCP, агент, CLAUDE.md — кто из них чтоСкопировано

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

Если коротко: CLAUDE.md — это статика, которая всегда с вами. Skill — это процедура, которую Claude достаёт из шкафа по ситуации. MCP — это новые руки, которыми Claude дотягивается до внешнего мира. Агент — это отдельный сотрудник на задачу.

Подробнее про MCP мы писали в отдельной статье про подключение MCP-серверов — там 10 готовых серверов под популярные задачи. Про slash-команды в Claude Code — в разборе всех 37 встроенных команд.

Когда скилл точно нужен, а когда хватит CLAUDE.mdСкопировано

Соблазн делать скилл под каждый чих большой, и это типичная ошибка новичков. Половина задач, под которые люди пилят скиллы, спокойно решается одной-двумя строчками в CLAUDE.md.

Простой чек-лист из 7 пунктов. Если хотя бы три ответа «да» — скилл оправдан. Если меньше — дополните CLAUDE.md и продолжайте жить.

1. У задачи есть три и больше шагов, которые надо делать в строгом порядке. «Сначала проверь X, потом сгенерируй Y, потом залей Z, потом сбрось кеш».
2. Вы объясняли это же Claude три раза за неделю, и каждый раз пишете примерно одно и то же длинное сообщение.
3. Есть моменты, где легко ошибиться — и вы каждый раз напоминаете «не забудь про X, иначе Y».
4. В процессе нужны вспомогательные файлы — шаблон, чек-лист, готовый код, JSON-схема. CLAUDE.md такое плохо вмещает.
5. Задача периодически меняется — и вам хочется править инструкцию в одном месте, а не в двадцати чатах.
6. Это командная процедура — и вы хотите, чтобы коллеги работали так же.
7. Запрос можно сформулировать одной фразой: «сделай X» — и Claude должен понять, какой скилл нужен.

Если у вас «исправь опечатку в заголовке» — скилл не нужен. Если «опубликуй статью на сайте: проверь ссылки, поставь мета-теги, обнови карту сайта, отправь в Search Console» — скилл нужен.

Анатомия скилла — из чего состоит SKILL.mdСкопировано

Минимальный скилл — это одна папка и один файл внутри:

~/.claude/skills/
└── moy-skill/
    └── SKILL.md

Имя папки = имя скилла. Имя файла строго SKILL.md, заглавными буквами, иначе Claude его не найдёт. Сам файл состоит из двух частей: YAML-шапка и тело инструкции.

Шапка (YAML frontmatter)

---
name: moy-skill
description: Что делает скилл и когда его вызывать. Триггеры: «сделай X», «когда Y».
---

Обязательны два поля: name и description. name совпадает с именем папки. description — это самое важное поле во всём скилле. По нему Claude решает, нужен ли скилл сейчас или нет.

Правило простое: описание читает модель, не человек. В нём должны быть две вещи: что скилл делает (одной фразой) и по каким триггерам его звать (конкретные фразы пользователя). Если вы напишете «Полезный скилл для работы с текстом» — Claude никогда сам его не найдёт.

Хороший пример описания:

description: Чистит русский текст от AI-маркеров вроде «в современном мире», «погрузиться в тему», «не X, а Y». 
Используй когда пользователь говорит «убери AI-измы», «почисти текст», «сделай человечнее», «аудит на AI».

Тело навыка Claude

Дальше идёт обычный markdown, который Claude читает как инструкцию. Структуры жёсткой нет, но большинство рабочих скиллов держатся на шести блоках:

• Цель. Какой результат и для кого. Одно-два предложения.
• Вход. Что приходит на старте: текст, файл, URL, аргументы.
• Процесс. Шаги в нужном порядке. Не «вообще-то надо», а «шаг 1, шаг 2».
• Проверка. Как понять, что результат не халтура. Конкретные критерии или команды.
• Формат ответа. Что именно вернуть пользователю в конце.
• Границы. Что скиллу запрещено делать. «Не трогай X», «не коммить без подтверждения».

Опциональные файлы рядом

В папке скилла можно положить что угодно ещё:

~/.claude/skills/moy-skill/
├── SKILL.md
├── examples/
│   ├── good.md
│   └── bad.md
├── scripts/
│   └── check.py
└── templates/
    └── post.html

В SKILL.md вы на эти файлы ссылаетесь: «возьми шаблон из templates/post.html», «прогони результат через scripts/check.py». Claude умеет читать локальные файлы и запускать скрипты — этим и пользуются.

Принцип называется прогрессивное раскрытие (progressive disclosure): сначала Claude видит только шапку всех скиллов, потом подгружает тело конкретного нужного, потом по ссылкам в теле — вспомогательные файлы. Это позволяет держать в одном скилле сотни килобайт справочника, не тратя контекст на остальные задачи.

Пишем первый скилл с нуля — анти-AI-фильтр за 30 минутСкопировано

Теория без практики не работает, поэтому соберём вместе один рабочий скилл с нуля. Задача — почистить текст от AI-маркеров: типичных фраз, по которым редактор сразу видит «писал ChatGPT».

Это реальная задача редакций. Мы в Checkroi пользуемся таким скиллом для всех блог-постов, и он экономит редактору по часу на статью.

Шаг 1 — придумайте имя и создайте папку

Имя должно быть коротким и отражать суть. Возьмём anti-ai-filter.

mkdir -p ~/.claude/skills/anti-ai-filter
cd ~/.claude/skills/anti-ai-filter
touch SKILL.md

Папка лежит в ~/.claude/skills/ — значит скилл будет личным и доступным во всех проектах. Если хотите скилл только для одного проекта, кладите в ./.claude/skills/ внутри проекта — тогда коллеги, у кого репозиторий, тоже его получат.

Шаг 2 — напишите шапку

Откройте SKILL.md и начните с YAML:

---
name: anti-ai-filter
description: Чистит русский текст от маркеров AI-генерации — «не X, а Y», «в современном мире», «погрузиться», «таким образом», «более того», избыточные тире. Используй когда пользователь говорит «убери AI-измы», «почисти текст», «сделай человечнее», «прогони через анти-AI», «отредактируй на живость».
---

Триггеры в описании — это слова, которые пользователь скажет, когда захочет вызвать скилл. Их стоит писать так, как вы сами говорите. Я добавил пять вариантов — чем больше, тем выше шанс, что Claude поймёт без явного вызова /anti-ai-filter.

Шаг 3 — пропишите цель и границы

Сразу после шапки добавьте короткую цель и что скилл НЕ делает. Границы важнее цели — они защищают от того, что Claude начнёт переделывать всё подряд.

# Anti-AI Filter

## Цель
Найти в тексте характерные AI-обороты и переписать их по-человечески. Сохранить смысл, факты, ссылки, цифры.

## Что НЕ делать
- Не менять смысл предложений
- Не удалять факты и цифры
- Не трогать прямую речь и цитаты
- Не переписывать заголовки, если пользователь явно не попросил
- Не превращать живой текст в «ещё более живой» — если предложение уже звучит как человек, оставить

Шаг 4 — соберите список того, что чистить

Это самая важная часть скилла. Чем конкретнее список, тем меньше шансов, что Claude начнёт «исправлять» нормальный текст. Вот рабочий минимум:

## Что чистить

### Конструкции с противопоставлением (главный AI-маркер)
- «не X, а Y» → одно утверждение
- «это не X — это Y» → одно утверждение
- «X, а не Y» → одно утверждение

### Канцеляризмы и штампы
- «в современном мире», «в эпоху», «в наши дни» → удалить или заменить на конкретику
- «таким образом», «подводя итог», «в заключение» → удалить
- «более того», «кроме того», «помимо этого» → удалить или заменить на «ещё»
- «стоит отметить», «важно подчеркнуть» → удалить
- «является», «представляет собой», «данный» (= этот) → заменить

### Метафоры-затычки
- «погружение», «погрузиться в тему» → «изучить», «разобраться»
- «ландшафт», «парадигма», «экосистема», «трансформация», «синергия» → конкретное слово
- «держит внимание», «держит темп» — в переносном смысле

### Усилители-паразиты
- «реально», «буквально», «действительно», «совершенно», «абсолютно»
- «без воды», «честно говоря», «прямо скажу»

### Типографика
- Длинное тире вместо запятой — заменить на запятую или точку
- Лимит тире: ≤ 1 на 1000 слов

Шаг 5 — пропишите процесс и проверку

Тут описываете, в каком порядке Claude должен идти по тексту:

## Процесс

1. Прочитай весь текст целиком, чтобы понять контекст
2. Пройди три прохода:
   - Первый: конструкции с противопоставлением (см. список)
   - Второй: канцеляризмы, штампы, метафоры
   - Третий: тире и пунктуация
3. На каждом проходе показывай предложение «было / стало» — пользователь должен видеть, что меняешь
4. В конце выдай итоговый текст и короткий отчёт: сколько правок, какого типа

## Проверка
- В финальном тексте нет ни одной фразы из списка
- Длинных тире не больше 1 на 1000 слов
- Смысл предложений сохранён
- Цифры и ссылки не тронуты

Шаг 6 — протестируйте

Сохраните файл, перезапустите Claude Code в терминале и дайте ему любой текст с AI-маркерами. Например, такой:

«В современном мире технологий важно отметить, что искусственный интеллект — это не просто инструмент, а целая парадигма. Более того, погружение в тему AI открывает реально огромные возможности. Таким образом, освоить нейросети — значит трансформировать свой подход к работе.»

Скажите Claude: «Прогони этот текст через анти-AI-фильтр». Если в описании вы поставили правильные триггеры, Claude сам подтянет скилл и вернёт что-то вроде:

«Искусственный интеллект — рабочий инструмент. Если разобраться с нейросетями, меняется подход к работе, и это уже видно на конкретных задачах: написать письмо, найти баг в коде, собрать отчёт.»

Готово. У вас работающий скилл за 6 шагов и примерно полчаса времени, включая чай.

Как Claude находит скилл и решает его запуститьСкопировано

Многих новичков это сбивает с толку: «я же написал скилл, почему он не вызывается?» Разберём механику.

При старте Claude Code сканирует три места:

• ~/.claude/skills/ — ваши личные скиллы
• ./.claude/skills/ — скиллы текущего проекта
• Плагины — скиллы из подключённых плагинов

Из каждой папки он читает только шапку SKILL.md: имя и описание. Тело пока не трогает — иначе контекст бы забивался.

Дальше есть два сценария.

Явный вызов через slash-команду. Если вы пишете /anti-ai-filter — Claude гарантированно подгружает тело этого скилла и идёт по нему. Это надёжнее всего и работает с любым описанием.

Авто-вызов по описанию. Если вы пишете обычным языком — «почисти текст от AI», «убери AI-измы» — Claude смотрит на описания всех доступных скиллов и решает, какой подходит. Если ваше описание содержит эти триггеры, скилл подтянется. Если описание расплывчатое («Скилл для редактуры») — Claude его пропустит.

Отсюда правило: в описании пишите конкретные фразы пользователя, которые должны его вызвать. Не «редактирует текст», а «используй когда пользователь говорит ‘почисти’, ‘убери AI-измы’, ‘сделай человечнее’». Это самое частое место, где новички ломают авто-вызов.

Где хранить скиллы — личные, проектные, плагиныСкопировано

Скиллы можно положить в трёх местах, и выбор зависит от того, кто ими будет пользоваться.

Личные. Папка ~/.claude/skills/ у вас в домашней директории. Работают во всех проектах. Сюда кладите всё, что нужно лично вам и что не зависит от конкретного кода: редактура, генерация идей, помощь с отчётами.

Проектные. Папка .claude/skills/ внутри репозитория. Работают только когда вы запустили Claude Code в этой папке. Коммитятся в git — значит достанутся всем, кто склонирует проект. Подходит для процедур, специфичных для одного проекта: «как у нас принято деплоить», «как мы пишем коммиты», «как обновить статью на сайте».

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

Для первого скилла начинайте с личных. Когда поймёте, что им пользуется ещё кто-то — переносите в проектные или плагин.

5 ошибок новичка при создании первого скиллаСкопировано

Эти грабли встречаются у 90% людей, кто пишет первый скилл. Лучше пройти их на чужих историях.

Ошибка 1 — расплывчатое описание скилла

Описание «Скилл для работы с текстом» Claude никогда не подтянет сам. Он не понимает, что значит «работа с текстом»: переписать, перевести, проверить орфографию, сократить, удлинить?

Фикс: в description конкретно опишите, что скилл делает И по каким фразам пользователя его вызывать. Минимум три триггерных фразы. Если скилл не вызывается — первым делом переписывайте description.

Ошибка 2 — простыня вместо процедуры

Новички пишут SKILL.md как эссе: «искусственный интеллект сейчас очень популярен, и важно понимать, что редактура текста — это сложная задача…» На тысячу слов рассуждений и ноль конкретики.

Фикс: скилл — это инструкция, а не статья. Структурируйте как чек-лист: цель, вход, шаги по номерам, проверка, что вернуть. Если описываете шаг словами «вообще-то стоит подумать о том, чтобы…» — это сигнал переписать в «шаг 3: запусти X, проверь Y».

Ошибка 3 — нет раздела «что НЕ делать»

Без границ Claude легко уносит в сторону. Если у скилла нет явных запретов, модель может начать «исправлять» вещи, которые исправлять не надо. Анти-AI-фильтр без границ начнёт переписывать прямую речь героев. Скилл для деплоя без границ запустит прод без подтверждения.

Фикс: обязательная секция «Что НЕ делать» или «Границы» в каждом скилле. Пишите её на основе реальных факапов: первые два раза скилл сломает что-то неожиданное — зафиксируйте это в запретах.

Ошибка 4 — нет проверки результата

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

Фикс: в каждом скилле — конкретные критерии «сделано хорошо». Для анти-AI-фильтра: «нет ни одной фразы из списка», «тире меньше 1 на 1000 слов». Для деплоя: «curl на живой URL вернул 200», «логи без ERROR». Если критерий можно проверить командой — поставьте команду прямо в скилл.

А ещё можно добавить команду /goal и тогда скилл будет делать ровно то, что ему сказано. А больше разных команд — в нашей подборке 37 команд Claude Code в 2026: полный разбор slash-команд Клода.

Ошибка 5 — один скилл на всё

«Сделаю универсальный скилл для редактуры, который и AI-измы убирает, и опечатки правит, и структуру меняет, и ссылки добавляет». Получается монстр на 3000 строк, в котором Claude путается и делает половину задач плохо.

Фикс: один скилл — одна задача, один формат ответа, одни критерии успеха. Два узких скилла почти всегда лучше одного широкого. Если очень хочется связку — делайте отдельные скиллы и пишите в CLAUDE.md «после anti-ai-filter прогоняй ещё через typo-checker».

Полезные скиллы редакции и где брать готовыеСкопировано

В Anthropic есть набор официальных скиллов, которые ставятся вместе с Claude Code. Самые полезные для нашей работы:

• humanizer — переписывает текст, чтобы убрать характерные AI-обороты. По духу близко к анти-AI-фильтру из примера выше, только построен на Wikipedia-гайде «Signs of AI writing».
• skill-creator — скилл для написания скиллов. Задаёт пару вопросов про задачу, проверяет существующие скиллы на дубли, генерирует структуру и шапку. Удобен, когда лень собирать SKILL.md руками. Лежит в пакете anthropic-skills.
• deep-research — многошаговое исследование с отслеживанием источников. Полезно, когда нужно собрать обзор темы из 10 источников и потом сослаться, откуда что взято.
• pdf, docx, pptx, xlsx — генераторы документов. PDF с таблицами и заголовками, презентации со слайдами и спикерскими заметками, эксельки с формулами — всё собирается одним вызовом скилла из текстового запроса.

Кроме официальных, есть открытые библиотеки скиллов на GitHub — например, репозиторий anthropics/skills с примерами для разработчиков. И есть авторские наборы скиллов от инженеров Anthropic и сторонних разработчиков — ищите по запросу «claude code skills github».

Мы в Checkroi пишем свои скиллы под редакционные задачи: SEO-оптимизация статей, генерация Pinterest-пинов, монтаж YouTube Shorts, обновление контента. У каждого скилла своя узкая зона: один пишет статьи, второй чинит ссылки, третий гоняет аудит. Это удобнее, чем держать всё в одном файле.

Если интересно посмотреть, как такая редакционная инфраструктура устроена изнутри — мы писали про AI-native подход к работе и команде в статье про AI-native людей и то, как они работают с инструментами. И про сравнение Claude Code с его главным конкурентом — в разборе Claude Code vs Cursor в 2026 году.

Где научиться работать с AI-инструментами и нейросетямиСкопировано

Skills — это надстройка над нейросетями. Чтобы получить от них максимум, полезно понимать, как устроены сами модели, как писать промпты, как соединять AI с рабочими задачами. На это не обязательно тратить год — грамотный месячный курс закроет 80% базы.

Мы собрали актуальные программы по нейросетям, AI-инструментам и промпт-инжинирингу — от коротких интенсивов на неделю до полугодовых программ с дипломом. В подборке есть курсы по Claude, ChatGPT, Midjourney, Stable Diffusion и по связке AI с разработкой:

Больше программ — в полном каталоге курсов по нейросетям и искусственному интеллекту

После курса возвращайтесь к этой статье и соберите свой первый рабочий скилл — уже не тренировочный, а под реальную задачу.