Claude Skills: что это и как расширить Claude Code

Скажем, ты уже несколько недель работаешь с Claude Code: пишешь промпт за промптом, собираешь свою «Змейку», просишь проверить код перед коммитом, генерировать SEO-статьи или разбираться с конкретным типом файлов. С каждым разом замечаешь, что часть задач повторяется. Одинаковые инструкции, одинаковые проверки, одинаковые форматы ответов. Хочется один раз объяснить Claude, как именно делать эту рутину, а потом просто вызывать готовый сценарий одной командой. Именно для этого в Claude Code есть Skills — навыки, которые расширяют возможности ассистента под твои повторяющиеся задачи.

Ниже разберём, что такое Claude Skills простыми словами, чем они отличаются от MCP, где взять готовые claude code skills, как установить их из GitHub и как написать свой под проект. Будет много практики, примеров для вайбкодера и честный вывод: когда skills реально экономят время, а когда лучше обойтись обычным промптом.

Что такое Claude Skills простыми словами

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

Проще говоря, skill — это рецепт. Ты один раз описываешь блюдо, указываешь ингредиенты и последовательность шагов, а потом вместо того, чтобы каждый раз рассказывать повару, как готовить, просто говоришь: «Приготовь по рецепту №3». Claude открывает рецепт и действует по нему.

Например, ты можешь создать skill для code review перед коммитом. Внутри будет написано:

• прочитай diff последних изменений;
• проверь, нет ли случайных console.log, секретов и закомментированного кода;
• убедись, что новые функции имеют понятные имена;
• если видешь проблему, сначала предложи исправление, а не сразу коммить;
• в конце дай краткое резюме: что изменилось и стоит ли коммитить.

Теперь вместо того чтобы каждый раз писать этот промпт, ты просто вводишь /review-diff — и Claude берёт инструкцию из skill.

Skills особенно полезны в вайбкодинге, потому что здесь много повторяющихся операций:

• генерация типовых файлов: компонентов, статей, тестов;
• проверка качества кода перед публикацией;
• работа с однотипными форматами: CSV, JSON, YAML, DOCX, PDF;
• написание документации по заданному шаблону;
• подготовка релизных заметок или changelog;
• аудит безопасности проекта.

Чем Claude Skills отличаются от MCP

Часто у новичков возникает путаница: если есть MCP (Model Context Protocol), зачем ещё skills? Оба инструмента расширяют Claude Code, но делают это по-разному.

MCP — это протокол, который подключает Claude к внешним инструментам и источникам данных. Через MCP Claude может общаться с базой данных, внешним API, браузером, системой поиска, таск-трекером или файловым хранилищем. MCP добавляет возможности взаимодействия с миром за пределами Claude Code.

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

Сравним на примере из жизни:

• MCP — это электрическая розетка и провод, который подключает твой ноутбук к сети. Без розетки у тебя нет питания.
• Skill — это инструкция «как сварить яйцо»: взять кастрюлю, налить воды, довести до кипения, опустить яйцо на шесть минут. Розетка (MCP) даёт энергию плите, но сама не готовит завтрак.

Например, у тебя может быть MCP-сервер, который читает базу данных Supabase. А skill будет говорить Claude: «Когда пользователь просит отчёт по рекордам, сначала через MCP получи данные из таблицы scores, затем сгруппируй по дням, построй простую таблицу и выведи три главных вывода». Без skill Claude умеет лазить в базу, но не знает, как именно ты хочешь видеть отчёт.

Если хочешь разобраться в MCP подробнее, читай статью /articles/chto-takoe-mcp. А базовые принципы работы с Claude Code описаны в /articles/chto-takoe-claude-code.

Где взять готовые Claude Skills

Ты можешь найти skills в трёх местах: официальный набор Anthropic, community-репозитории на GitHub и собственные скиллы под свой проект.

Официальный набор Anthropic

Компания Anthropic публикует набор официальных skills, которые покрывают типичные задачи работы с файлами и документами. Обычно в него входят навыки для работы с DOCX, PDF, PPTX, XLSX и другими распространёнными форматами. Это не плагины, а инструкции, которые помогают Claude правильно читать, анализировать и генерировать такие файлы.

Официальные skills — хорошая отправная точка, потому что они:

• соответствуют рекомендациям Anthropic;
• протестированы на типичных сценариях;
• не требуют сложной настройки;
• лежат в открытом репозитории и обновляются там.

В сам Claude Code документные скиллы (DOCX, PDF, PPTX, XLSX) не встроены: их ставят как плагин из официального репозитория github.com/anthropics/skills двумя командами внутри Claude Code — /plugin marketplace add anthropics/skills, затем /plugin install document-skills@anthropic-agent-skills. Там же лежит skill-creator и другие примеры. Формат SKILL.md и правила для Claude Code описаны в документации: code.claude.com/docs/en/skills.

Community-скиллы на GitHub

Поисковый запрос claude skills github выдаёт множество репозиториев, где разработчики делятся собственными skills. Это может быть что угодно: от навыка для генерации диаграмм Mermaid до скилла для аудита безопасности кода или подготовки релизных заметок.

Community-скиллы полезны, потому что они:

• решают узкие задачи, которые Anthropic не покрывает;
• показывают, как устроены skill-файлы на практике;
• дают шаблоны, которые можно адаптировать под себя.

Но здесь есть важное предупреждение: не все community-скиллы безопасны. Поскольку skill — это набор инструкций для Claude, автор может вписать туда вредоносные действия: удаление файлов, отправку данных куда-либо, игнорирование стандартных проверок безопасности. Поэтому ставить skill стоит только из проверенных источников и обязательно читать его содержимое перед установкой.

Свой skill под проект

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

Для вайбкодера это особенно ценно. Каждый проект имеет свои соглашения: как называть компоненты, где хранить изображения, как оформлять коммиты, какой тон использовать в текстах. Один раз записав эти правила в skill, ты превращаешь Claude в помощника, который знает стандарты твоего проекта.

Как устроен skill изнутри

Чтобы не бояться создавать собственные skills, полезно понять их устройство. Skill — это, как правило, папка с несколькими файлами. Главный из них — SKILL.md, где записана инструкция для Claude.

Минимальная структура skill может выглядеть так:

.claude/skills/my-skill/
├── SKILL.md
├── examples/
│   ├── input.md
│   └── output.md
└── templates/
    └── article-template.md

Файл SKILL.md состоит из двух частей: YAML-шапки между двумя строками --- и обычного markdown-текста под ней. Шапка начинается с первой строки файла, в ней два ключевых поля — name и description. В Claude Code name можно опустить, тогда именем станет название папки; для загрузки в claude.ai или через API оба поля обязательны, name — до 64 символов строчными латинскими буквами, цифрами и дефисами, description — до 1024 символов. По description Claude решает, подходит ли скилл к текущей задаче, поэтому описывай в нём не только что скилл делает, но и когда его применять.

Дальше в тексте под шапкой обычно идут:

• Название и назначение. Что делает этот skill и когда его использовать.
• Алгоритм работы. Пошаговая инструкция: что проверить, в каком порядке действовать, какие инструменты вызывать.
• Формат ответа. Как должен выглядеть результат: структура, заголовки, длина, стиль.
• Ограничения. Чего не делать: не удалять файлы без разрешения, не публиковать код, не использовать устаревший синтаксис.
• Примеры. Один-два примера входных данных и желаемого результата.

Claude Code при вызове skill читает SKILL.md и использует его как системную инструкцию для текущей задачи. Дополнительные файлы в папке — шаблоны, примеры, справочники — он может читать по мере необходимости.

Пример простого SKILL.md

Допустим, ты часто просишь Claude проверить статью перед публикацией. Skill может выглядеть так:

---
name: article-review
description: Проверяет статью перед публикацией — структура, язык, SEO. Используй, когда просят проверить или вычитать текст статьи.
---

# Проверка статьи перед публикацией

## Когда использовать
Когда пользователь просит «проверь статью» или вызывает /article-review.

## Шаги
1. Прочитай файл статьи, который указал пользователь.
2. Проверь структуру: есть ли ввод, развёрнутые разделы, практический блок и заключение.
3. Проверь язык: убери канцеляризмы, проверь согласование, убедись, что термины пояснены при первом употреблении.
4. Проверь SEO: есть ли ключевая фраза в заголовке, первом абзаце и хотя бы в одном H2.
5. Если находишь ошибки, сначала перечисли их кратко, затем предложи исправленный вариант.
6. В конце дай общую оценку: «Можно публиковать», «Нужны небольшие правки» или «Требуется доработка».

## Чего не делать
- Не меняй смысл авторских мыслей.
- Не добавляй фактов, которых нет в исходном тексте.
- Не удаляй файлы.

Такой skill превращает размытый запрос «проверь статью» в предсказуемый процесс с понятным результатом.

Как установить и использовать Claude Skills

Установка skill в Claude Code сводится к тому, чтобы положить папку со skill в директорию .claude/skills в корне проекта. Если папки .claude/skills ещё нет — создай её. Второй адрес — личная папка ~/.claude/skills в домашнем каталоге: скиллы оттуда доступны сразу во всех твоих проектах, и туда стоит класть всё, что не привязано к конкретному репозиторию.

Skills работают не только в Claude Code. Ту же папку можно загрузить zip-архивом в claude.ai (Settings → Features; свои скиллы — на тарифах Pro, Max, Team и Enterprise при включённом выполнении кода, встроенные документные — и на Free) или через Skills API. Между площадками скиллы не синхронизируются: в Claude Code они живут в файлах, в claude.ai и API их нужно загружать отдельно.

Шаг 1. Создай структуру

В корне проекта сделай папку:

.claude/skills/

Внутрь неё помещай каждый skill в отдельную подпапку. Название подпапки станет именем команды. Например:

.claude/skills/
├── review-diff/
│   └── SKILL.md
├── generate-article/
│   ├── SKILL.md
│   └── templates/
│       └── article-template.md
└── security-audit/
    └── SKILL.md

Шаг 2. Помести файлы skill

Скопируй в папку skill файлы из официального репозитория Anthropic или community-репозитория. Если пишешь свой skill — создай SKILL.md и любые вспомогательные файлы.

Шаг 3. Проверь, что skill подхватился

Claude Code следит за папками скиллов и подхватывает добавленный, изменённый или удалённый SKILL.md прямо в текущей сессии, перезапуск не нужен. Исключение одно: если ты создал саму папку skills, которой не было при старте сессии, Claude Code нужно перезапустить, чтобы он начал за ней следить.

Шаг 4. Вызови skill

Теперь вводи команду вида /название-скилла. Например:

/review-diff

Claude загрузит инструкцию из SKILL.md и спросит, над чем применить skill, либо сразу начнёт работу, если в команде уже есть контекст.

Когда Claude сам предлагает skill

Claude Code умеет предлагать подходящий skill, когда видит соответствие между твоей задачей и описанием skill. Например, если ты пишешь: «Сделай презентацию из этой статьи», а в проекте есть skill для работы с PPTX, Claude может предложить использовать его. Это экономит время и снижает вероятность ошибки.

Практический пример для вайбкодера: три полезных скилла

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

Skill 1: проверка diff перед коммитом

Когда ты работаешь с Claude Code, легко нагенерировать много изменений и забыть проверить, что именно попадёт в коммит. Skill /review-diff помогает не закоммитить случайный мусор.

Что делает skill:

1. Запрашивает diff текущих изменений через git diff.
2. Проверяет, нет ли в коде console.log, debugger, временных комментариев и тестовых строк.
3. Ищет потенциальные утечки секретов: токены, пароли, API-ключи.
4. Оценивает качество имён переменных и функций.
5. Проверяет, не затронуты ли файлы, которые не должны были изменяться.
6. Даёт вердикт: «можно коммитить», «нужны правки» или «лучше откатить».

Такой skill особенно полезен, когда ты часто просишь Claude «сделай что-нибудь» и потом сам не помнишь, что изменилось.

Skill 2: генерация SEO-статьи

Скажем, ты ведёшь блог проекта и регулярно публикуешь статьи. Вместо того чтобы каждый раз объяснять структуру, тон, длину и ключевые слова, можно создать skill /generate-article.

В SKILL.md будет записано:

• статья должна быть 1200–1500 слов;
• обращение на «ты», без сюсюканья;
• структура: интро → 4–5 разделов H2 → практический блок → FAQ → заключение;
• ключевая фраза должна быть в заголовке, excerpt и первом абзаце;
• примеры — на «Змейке» или простых аналогиях;
• в конце — чек-лист для самопроверки.

Теперь ты пишешь: «/generate-article на тему "как добавить звук в игру на JavaScript"» — и Claude сразу знает, в каком формате писать.

Skill 3: skill-creator для создания своих skills

Самый мета-уровень — skill, который помогает создавать другие skills. Он задаёт Claude стандартный шаблон и проверяет, что новый skill:

• имеет понятное название и назначение;
• содержит пошаговый алгоритм;
• включает примеры входных и выходных данных;
• имеет раздел «чего не делать»;
• не противоречит другим skills в проекте.

Такой skill экономит время, когда в проекте появляется много повторяющихся задач и хочется оформить их в отдельные рецепты.

Как связать skills с проектом «Змейка»

Если ты проходишь курс skillmake и собираешь браузерную игру «Змейка», skills могут помочь на каждом этапе:

• На этапе вёрстки: skill для генерации HTML-структуры по заданному шаблону.
• На этапе логики: skill для написания чистых функций и проверки их на чистоту.
• На этапе публикации: skill для подготовки проекта к GitHub Pages: проверка путей, отсутствие локальных ссылок, наличие README.
• На этапе монетизации: skill для генерации текстов для маркетинговых материалов.

Ключевая идея: один раз настроил — много раз используешь. Это и есть главная ценность skills.

Безопасность: что проверять перед установкой

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

Что проверять

Перед тем как положить skill в .claude/skills, открой его файлы и проверь:

1. Источник. Кто автор? Официальный репозиторий Anthropic, известный разработчик или незнакомый аккаунт с одним репозиторием?
2. Содержимое SKILL.md. Что именно Claude будет делать? Есть ли подозрительные шаги вроде «отправь файл на внешний сервер» или «удали все файлы»?
3. Скрипты и исполняемые файлы. Если skill содержит bash-скрипты, Python-файлы или бинарники, изучи их код. Если не умеешь читать код — не устанавливай такой skill.
4. Разрешения. Требует ли skill доступа к секретам, токенам, SSH-ключам? Если да, убедись, что это обосновано.
5. Актуальность. Когда последний раз обновлялся skill? Устаревшие инструкции могут конфликтовать с новой версией Claude Code.

Как защитить секреты

Если skill работает с внешними сервисами, никогда не храни токены и пароли прямо в файлах проекта. Используй переменные окружения или менеджеры секретов. Подробнее о хранении токенов читай в статье /articles/hranenie-sekretov-i-tokenov.

Простое правило

Частые вопросы

Что такое Claude Skills простыми словами?

Это готовые инструкции-пакеты для Claude Code. Ты кладешь папку со skill в проект, вызываешь его командой /название-скилла, и Claude работает по заданному сценарию. Это помогает автоматизировать повторяющиеся задачи: code review, генерацию статей, работу с файлами.

Чем Claude Skills отличаются от MCP?

MCP подключает Claude к внешним инструментам и данным, например к базе данных или API. Skill — это готовая инструкция внутри Claude Code, которая говорит, как выполнять конкретную задачу, часто используя уже подключённые инструменты. MCP добавляет «руки», skill добавляет «рецепт».

Где взять готовые Claude Code skills?

Есть три источника: официальный набор Anthropic (github.com/anthropics/skills), community-репозитории на GitHub по запросу claude skills github, и собственные скиллы, которые ты пишешь под свой проект. Официальные и проверенные community-скиллы безопаснее всего.

Нужно ли уметь программировать, чтобы написать skill?

Нет. Skill — это прежде всего текстовая инструкция в файле SKILL.md. Если ты умеешь чётко описать последовательность шагов, ты сможешь написать skill. Иногда полезно добавить шаблоны или примеры, но программировать не обязательно.

Можно ли использовать skills вместе с MCP?

Да, и часто это самый эффективный подход. MCP даёт доступ к данным и внешним сервисам, а skill говорит Claude, что именно с ними делать. Например, MCP может читать таблицу рекордов, а skill — формировать из этих данных красивый отчёт.

Безопасны ли сторонние skills?

Не все. Поскольку skill — это набор инструкций, злоумышленник может вписать туда вредоносные действия. Поэтому важно устанавливать skills только из проверенных источников и читать их содержимое перед установкой. Секреты и токены никогда не храни внутри skill.

Заменяют ли skills обычные промпты?

Нет. Skills — это дополнение, а не замена. Они хороши для повторяющихся задач с чётким алгоритмом. Для разовых, творческих или исследовательских задач обычный промпт часто удобнее и гибче.

Честный вывод

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

Но важно помнить: skills — это дополнение к основным навыкам работы с промптами, а не их замена. Если ты только начинаешь работать с Claude Code, сначала научись чётко формулировать задачи. Когда заметишь, что какая-то задача повторяется из раза в раз — самое время оформить её в skill.

Если хочешь углубиться в искусство промптов, читай статью /articles/kak-pisat-prompty-claude-code. А если ещё не разобрался, чем MCP отличается от skills, вернись к /articles/chto-takoe-mcp.

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