ГлавнаяБлогClaude Skills

Claude Skills: что это, как создать и установить скилл

8 июля 202611 миннейросети

Зачем это нужно

Если ты гоняешь Claude на серьёзных задачах, наступает момент: ты в десятый раз объясняешь одно и то же. Как оформлять коммиты. Как писать Title под SEO. Какой у тебя стек и стиль кода. Каждую сессию — заново. Промпт разрастается, а половина инструкций нужна не всегда, а раз в неделю.

Скиллы (Claude Skills, они же Agent Skills) решают ровно это. Ты один раз описываешь процедуру или знание в файле SKILL.md, и дальше Claude достаёт его сам — но только когда задача подходит. Остальное время скилл не занимает контекст. Разберу, как они устроены, как собрать свой за пять минут и куда его положить — в Claude Code, в веб-версии Claude.ai и через API.

Коротко для тех, кто спешит: скилл — это папка с файлом SKILL.md внутри. В файле — описание (когда его применять) и инструкции (что делать). Кладёшь папку в нужное место — и всё.

Что такое скилл и как он грузится

Скилл — это переиспользуемый навык в виде markdown-файла. Не плагин, не код, который надо компилировать, а текст с инструкциями плюс, по желанию, скрипты и справочные файлы рядом. Главная фишка — progressive disclosure, поэтапная загрузка. Именно она отличает скилл от «просто большого промпта».

📋
Старт сессии
грузятся только описания всех скиллов (~пара строк)
🎯
Задача подошла
подгружается полный SKILL.md — только этого скилла
📎
Если нужно глубже
по ссылке грузятся доп. файлы и скрипты
Три уровня загрузки. Пока скилл не пригодился, в контексте висит только его описание — копейки токенов. Полное содержимое подтягивается по факту.

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

Посчитаем на пальцах. Пусть у тебя скилл на 10 000 токенов плюс справочный файл ещё на 5 000. Если в этой сессии он не пригодился — ты заплатил только за описание, сотню токенов. Если пригодился один раз — полная стоимость, но ровно один раз за сессию, а не в каждом запросе. Двадцать таких скиллов в фоне стоят копейки, пока молчат. Тот же объём знаний в промпте или CLAUDE.md висел бы в каждом сообщении и быстро съел бы окно.

Ещё нюанс на длинных сессиях: когда контекст переполняется и происходит компактация, у уже использованных скиллов сохраняется верхняя часть — самое важное. Если скилл нужен целиком после этого, его достаточно вызвать заново.

Два типа скиллов

По сути скиллы бывают двух видов, и держать их в голове раздельно удобно — от типа зависит, как ты его настроишь.

Скилл-знание
Справочник, к которому Claude обращается по ходу дела: конвенции API, стиль кода, гайд по бренду. Не «сделай что-то», а «вот как у нас принято». Спокойно живёт на автовызове — подтянется, когда пишешь код.
Скилл-процедура
Пошаговый воркфлоу с началом и концом: деплой, коммит, ревью. Часто с disable-model-invocation и вызовом руками, чтобы не запустился сам в неподходящий момент.
Знание — «как правильно»; процедура — «сделай по шагам». Знание держи на автовызове, процедуру с побочными эффектами — на ручном.

На практике граница гибкая: один скилл может и объяснять правило, и выполнять по нему действие. Но когда сомневаешься, как настроить, — спроси себя: это справка, которую Claude читает между делом, или команда, которую он запускает? От ответа зависит, ставить disable-model-invocation или нет.

Анатомия SKILL.md

Весь скилл — это один обязательный файл SKILL.md. Он состоит из двух частей: YAML-шапка (frontmatter) сверху и инструкции ниже. Минимально нужны два поля в шапке.

SKILL.md
# YAML-шапка — метаданные
---
name: seo-title
description: Генерирует SEO Title и Description под
  ключевой запрос. Использовать, когда просят
  заголовок или мета-описание для страницы.
---

# Тело — инструкции для Claude
# SEO Title и Description

Когда дают тему или ключевой запрос:

1. Title — до 60 символов, ключ в начале, без воды.
2. Description — до 160 символов, с призывом.
3. Дай 3 варианта на выбор.

## Правила
- Ключ — в первых словах Title.
- Не дублируй Title в Description.
Реальный рабочий скилл. Именно description Claude читает при старте и по нему решает, когда скилл достать — поэтому пиши его конкретно.

Ключевые поля шапки:

Поле Зачем
descriptionглавное поле: что делает скилл и когда применять. По нему Claude вызывает скилл сам
nameимя (по умолчанию = имя папки). Под ним вызываешь вручную: /seo-title
allowed-toolsинструменты, что разрешены без лишнего запроса, пока скилл активен
disable-model-invocationtrue — только ручной вызов. Для скиллов с побочными эффектами (деплой)
Обязателен по сути только description — с него всё и начинается. Остальное опционально.

Если инструкций много, не пихай всё в один файл. Клади рядом reference.md, примеры и скрипты, а в SKILL.md ссылайся на них — Claude подтянет их только когда полезет глубже.

Живые данные и аргументы

Скилл — не статичная памятка. Он умеет две вещи, которые превращают его в рабочий инструмент: подставлять свежие данные прямо в момент вызова и принимать аргументы, как shell-скрипт.

Живой контекст через !`команда`

Строка вида !`git diff HEAD` в теле скилла выполняется в момент активации, и Claude получает результат сразу в контекст. Не «сходи проверь», а уже готовые данные под задачей:

--- description: Разбирает незакоммиченные изменения и подсвечивает риски. --- ## Текущие изменения # подставится живой diff в момент вызова !`git diff HEAD` ## Задача Суммируй изменения в 2-3 пунктах и подсвети риски: хардкод, отсутствие обработки ошибок, забытые тесты.
Claude увидит не инструкцию «посмотри diff», а сам diff — актуальный на секунду вызова.

Аргументы

Скилл принимает параметры через $0, $1 или $ARGUMENTS — как shell-скрипт. Вызываешь /deploy production, и внутри скилла $0 = production. Так один скилл работает под разные окружения без копий.

!`команда` работает только в теле, не в шапке. И это preprocessing — команда реально запускается при активации скилла. Поэтому для скиллов с побочными эффектами (деплой, отправка) ставь disable-model-invocation: true, чтобы Claude не дёрнул их сам.

Как создать свой скилл

Ничего собирать не надо — создаёшь папку и файл. Вот личный скилл, доступный во всех твоих проектах (для Claude Code):

terminal
# 1. создаём папку скилла
mkdir -p ~/.claude/skills/seo-title

# 2. кладём в неё SKILL.md
nano ~/.claude/skills/seo-title/SKILL.md
# (вставляешь frontmatter + инструкции из примера выше)

# 3. проверяем — изменения видны сразу
claude
# в сессии: /seo-title  или просто попроси заголовок
Личный скилл — в ~/.claude/skills/. Проектный, который поедет в репозиторий и будет общим для команды, — в .claude/skills/ внутри проекта.

Главное правило хорошего скилла — сильное описание. Ставь ключевой сценарий в начало («Генерирует SEO Title…», а не «Этот скилл анализирует…») и добавь фразы-триггеры («когда просят заголовок»). По описанию Claude решает, доставать скилл или нет — размытое описание = скилл не сработает.

Как писать description, чтобы скилл срабатывал

Почти все проблемы со скиллами — в описании. Claude выбирает скилл только по полю description, полного текста он в этот момент не видит. Размытое описание — и скилл пылится, даже если внутри всё идеально.

✗ Плохо
«Этот скилл помогает работать с текстами и делать разные полезные вещи с контентом.»
✓ Хорошо
«Генерирует SEO Title и Description под ключ. Использовать, когда просят заголовок или мета-описание страницы.»
Один и тот же скилл. Левый Claude не найдёт никогда, правый подтянет ровно на нужном запросе.

Четыре правила рабочего описания:

1. Ключевой сценарий — в начало. «Генерирует SEO Title…», а не «Этот скилл предназначен для…». Первые слова весят больше.

2. Фразы-триггеры. «Использовать, когда просят…», «Подходит для…» — прямо называй ситуацию, в которой скилл нужен.

3. Конкретика вместо «разное/полезное». Абстракции Claude не с чем сопоставить.

4. Держи до ~1500 символов. Длиннее — обрежется, и хвост описания просто не прочитается.

Полный пример: скилл со скриптом

Теперь настоящий скилл, а не «hello world»: считает статистику текста — слова, время чтения, плотность ключа — через маленький питон-скрипт. Тут видно, как в скилл кладут исполняемый код. Структура папки:

~/.claude/skills/content-stats/ ├── SKILL.md └── scripts/ └── stats.py

Файл SKILL.md — инструкция + вызов скрипта:

--- name: content-stats description: Считает статистику текста — слова, время чтения, плотность ключа. Использовать, когда просят проверить длину или SEO-метрики статьи. allowed-tools: Bash(python3 *) --- # Статистика контента Когда дают путь к файлу и ключевой запрос: 1. Запусти: `python3 scripts/stats.py <файл> <ключ>` 2. Покажи слова, знаки, время чтения, плотность ключа. 3. Если плотность выше 4% — предупреди о переспаме.

И сам скрипт scripts/stats.py:

import sys, re text = open(sys.argv[1], encoding='utf-8').read() key = sys.argv[2].lower() n = len(re.findall(r'\w+', text.lower())) dens = round(text.lower().count(key) / max(n,1) * 100, 2) print(f"Слов: {n}") print(f"Время чтения: {round(n/180)} мин") print(f"Плотность '{key}': {dens}%")
Вызов: /content-stats article.md "автоотклик" — Claude запустит скрипт, получит цифры и объяснит их человеческим языком.

Мораль: markdown-инструкции — для мягких правил и знаний, а скрипты — для точных вычислений и валидации. Скилл объединяет и то, и другое в одной папке.

Второй пример: скилл на bash

Скрипт в скилле — это не обязательно питон, а любой исполняемый код, хоть bash. Соберём боевой: проверка статьи перед публикацией — длина Title, число внутренних ссылок и стоп-слова из отдельного файла. Заодно покажу многофайловый скилл, где список правил вынесен в references/ и подгружается отдельно от инструкции.

~/.claude/skills/pre-publish/ ├── SKILL.md ├── references/ │ └── stop-words.txt └── scripts/ └── check.sh

Файл SKILL.md — короткая инструкция: что запустить и как читать вывод.

--- name: pre-publish description: Проверяет статью перед публикацией — длину Title, число внутренних ссылок и стоп-слова. Использовать перед выкладкой поста в блог. allowed-tools: Bash(bash scripts/check.sh *) --- # Проверка перед публикацией Когда дают путь к HTML-файлу статьи: 1. Запусти: `bash scripts/check.sh <файл>` 2. Разбери вывод: Title (норма 30–60 знаков), ссылки (норма ≥3), стоп-слова. 3. Нашлись стоп-слова — предложи живую замену. Список правил — в references/stop-words.txt.

Скрипт scripts/check.sh делает всю точную работу — на чистом bash:

#!/usr/bin/env bash f="$1" title=$(grep -oP '(?<=<title>).*?(?=</title>)' "$f" | head -1) # ${#title} — длина строки в знаках echo "Title (${#title} зн.): $title" echo "Внутренних ссылок: $(grep -oE 'href=\"/[a-z]' "$f" | wc -l)" echo "Стоп-слова:" # -F fixed, -f патерны из файла, -o только совпадения grep -oiFf "$(dirname "$0")/../references/stop-words.txt" "$f" | sort | uniq -c
Стоп-слова лежат в references/stop-words.txt — по слову на строку (данный, является, в рамках…). Правишь список — логику скрипта трогать не нужно.

Вызов: /pre-publish blog/new-post/index.html. Claude запустит скрипт, увидит «в тексте 3 раза "является"» — и предложит переписать эти места живым языком. Точную проверку делает bash, а осмысление и правку — сам Claude. Это и есть разделение труда внутри одного скилла.

allowed-tools и безопасность

Скилл может запускать команды и скрипты — значит, стоит понимать, что он делает с твоей машиной. Управляется это полем allowed-tools: оно заранее одобряет инструменты, пока скилл активен, чтобы Claude не спрашивал разрешение на каждый шаг. Задаётся glob-паттернами:

# разрешить все git-команды и чтение файлов allowed-tools: Bash(git *) Read # разрешить только конкретную сборку allowed-tools: Bash(npm run build)

Ключевой момент: allowed-tools — это не ограничение, а предодобрение. Claude всё ещё может запросить инструмент, которого нет в списке, — просто спросит разрешение. Если нужно именно запретить, есть обратное поле disallowed-tools.

Правила безопасности: не ставь чужой скилл не глядя — открой SKILL.md и скрипты, посмотри, что он запускает. Проектные скиллы из незнакомого репозитория требуют подтверждения доверия к папке. А скиллы, которые деплоят или что-то отправляют, держи на disable-model-invocation: true, чтобы Claude не дёрнул их без твоей команды.

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

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

Claude Code (CLI)
Положи папку скилла в ~/.claude/skills/ (личный) или .claude/skills/ (проектный). Готовые — из маркетплейса: /plugin install.
Claude.ai (веб)
Настройки → Capabilities → загрузить скилл, выбрать файл. Доступно на платных планах.
API / Agent SDK
Скиллы из .claude/skills/ проекта подхватываются агентом автоматически при работе через SDK.
Личные и проектные скиллы в Claude Code перезагружаются на лету — правишь файл, изменения видны в текущей сессии.

Готовый набор скиллов ставится из официального маркетплейса Anthropic одной командой прямо в сессии Claude Code:

# подключить официальный маркетплейс /plugin marketplace add anthropics/skills # поставить набор скиллов для документов /plugin install document-skills@anthropic-agent-skills # посмотреть все загруженные скиллы /skills

Как раздать скилл команде

Личный скилл в ~/.claude/skills/ живёт только у тебя. Чтобы им пользовалась вся команда — положи его в проектную папку .claude/skills/ и закоммить в репозиторий. Дальше он едет вместе с кодом: клонировал проект — скилл уже на месте. Это превращает наработки одного человека в общую «мышечную память» команды.

Если имена совпали (личный и проектный скилл называются одинаково), Claude берёт по приоритету:

Организация Личный ~/.claude Проектный .claude Плагин
Кто левее — тот и выигрывает при конфликте имён. Скилл от организации перебьёт твой личный, личный — проектный.

Хочешь раздать скилл шире одного репозитория — упакуй его в плагин и опубликуй в маркетплейс. Тогда любой поставит его командой /plugin install, как официальные наборы Anthropic.

Готовые скиллы: что уже есть

Свой писать не обязательно — многое уже готово. Официальный репозиторий anthropics/skills (под 160 тысяч звёзд) — это и библиотека примеров, и шаблон для своего скилла.

📄 Документы
docx, pptx, xlsx, pdf — Claude создаёт и редактирует Word, презентации, таблицы и PDF по-настоящему.
🎨 Дизайн и креатив
Оформление, брендинг, генерация артефактов — то, что ищут по «claude design skills».
⚙️ Разработка
Тесты веб-приложений, генерация MCP-серверов, кодовые процедуры.
🛠 Встроенные
В Claude Code сразу есть /code-review, /debug, /batch, /loop и другие — тоже скиллы.
Плюс skill-creator — скилл, который тестирует и улучшает твои скиллы: гоняет их на примерах и предлагает, как усилить описание.

Конкретные скиллы, которые стоит забрать первыми — ссылки прямые, на официальный репозиторий:

skill-creatorсоздаёт и тестирует твои скиллы — с него удобно начинать mcp-builderгенерирует MCP-сервер по описанию — не пишешь руками docx · pptx · xlsx · pdfWord, презентации, Excel и PDF по-настоящему brand-guidelinesприменяет твой брендбук к материалам автоматически frontend-designаккуратный фронтенд-дизайн вместо «страшненького» дефолта webapp-testingпрогоняет веб-приложение и проверяет, что работает canvas-designдизайн-макеты и графика на canvas claude-apiсправка по Claude API: модели, цены, параметры
Полный каталог с исходниками — github.com/anthropics/skills. Открываешь папку скилла, копируешь к себе — и он твой.

Разбор боевого скилла: как устроен pdf

Теория складывается, когда разбираешь живой скилл по косточкам. Возьмём официальный pdf от Anthropic — он читает, режет, склеивает и шифрует PDF, заполняет формы, гонит OCR по сканам. И это эталон того, как прогрессивное раскрытие работает на практике.

Первое, на что стоит посмотреть, — его description. Вот он почти как есть (чуть подрезан):

--- name: pdf description: Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables, merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, filling PDF forms, encrypting/decrypting, and OCR on scanned PDFs… ---

Заметь, как описание перечисляет чуть ли не каждый сценарий и синоним: reading, extracting, merging, splitting, filling forms, OCR. Это не многословие ради объёма, а приманка для срабатывания: как бы человек ни сформулировал запрос про PDF, он попадёт в одну из этих формулировок — и Claude подхватит скилл. Первый урок разбора: description пишут под то, как реальные люди просят, а не как покрасивее.

Теперь структура папки — и тут вся соль:

skills/pdf/ ├── SKILL.md 314 строк · обзор + быстрый старт ├── reference.md 611 строк · продвинутое, по требованию ├── forms.md 294 строки · только для заполнения форм └── scripts/ 8 питон-скриптов точных операций ├── fill_fillable_fields.py ├── convert_pdf_to_images.py ├── extract_form_structure.py └── … ещё пять

Эти файлы грузятся не сразу, а тремя уровнями — по мере надобности:

1
Всегда в контексте — только description, ~60 токенов. Claude просто знает, что есть скилл про PDF.
2
Скилл сработал — читается тело SKILL.md (314 строк): обзор и быстрый старт под типовые операции.
3
Задача глубже — Claude сам открывает reference.md (611 строк) для редких операций или forms.md для форм и запускает нужный скрипт из scripts/.

Ключевой вывод: reference.md на 611 строк весит ноль токенов, пока ты не попросишь что-то нетривиальное. forms.md не открывается, пока речь не зашла о формах. Скилл может быть сколь угодно большим и умным — в контексте он занимает крохи, потому что тяжёлые куски лежат на полке и снимаются только под конкретную задачу. Ровно так строй и свои: короткий SKILL.md сверху, тяжёлые справочники и скрипты — отдельными файлами рядом.

Какие скиллы собрать первым делом

Абстракции абстракциями, но вот пять скиллов, которые реально экономят время, если работаешь с контентом и трафиком. Каждый — папка с SKILL.md, собирается за вечер, а окупается на первой же неделе.

seo-titleгенерит Title и Description под ключ по твоим правилам длины и вхождения
content-statsсчитает длину, время чтения и плотность ключа — тот самый со скриптом выше
article-reviewпрогоняет черновик по чеклисту: вода, структура заголовков, перелинковка
meta-checkпроверяет Title и Description на длину и наличие ключа перед публикацией
tone-of-voiceдержит твой стиль письма — тон, запрещённые слова, длину абзацев
Принцип один: то, что ты объясняешь Claude каждый раз, оформи один раз скиллом.

Через месяц такой работы у тебя личная библиотека навыков, которая едет за тобой из проекта в проект. Начни с одного — самого частого повтора в твоей рутине, — и добавляй по мере того, как ловишь себя на «опять объясняю то же самое». Заготовки под контент-скиллы, кстати, уже есть в подборке промтов для SEO-контента — их легко завернуть в SKILL.md.

Скилл vs MCP, сабагенты и CLAUDE.md

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

Механизм Что это Когда брать
Скиллинструкции и знания, что грузятся по требованиюповторяемые процедуры, справочники, воркфлоу
MCPпротокол подключения внешних сервисовбаза данных, Slack, браузер, внешние API
Сабагентизолированный воркер со своим контекстомпараллельная работа, тяжёлый ресёрч по многим файлам
CLAUDE.mdконтекст, что грузится всегда и целикомправила «всегда делай так» (стек, стиль)
Простая развилка: правило на каждый запрос — в CLAUDE.md; внешнее подключение — MCP; процедура по случаю — скилл; тяжёлая параллельная работа — сабагент.

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

Если скилл не срабатывает

Четыре самых частых грабли — и что делать.

Скилла нет в списке
Проверь командой /skills. Если нет — скорее всего битый YAML в шапке: скилл грузится без description. Проверь отступы и --- сверху и снизу.
Не срабатывает сам
Слабое description. Добавь ключевой сценарий в начало и фразы-триггеры. Пока правишь — вызывай вручную /имя-скилла.
Срабатывает слишком часто
Сделай description уже и конкретнее. Если скилл вообще не должен вызываться автоматически — disable-model-invocation: true.
Правки не видны
Личные и проектные скиллы перезагружаются на лету. Если изменения не подхватились — перезапусти сессию, скилл из плагина — командой /reload-plugins.
В 9 случаях из 10 корень — либо битый YAML в шапке, либо размытое description. Начинай проверку с них.

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

Что такое Claude Skills простыми словами?
Скилл — это папка с файлом SKILL.md, где лежат инструкции и, по желанию, скрипты. Claude подгружает её не всегда, а только когда задача подходит под описание скилла. Грубо говоря, это сохранённый навык: один раз описал процедуру — дальше Claude выполняет её сам, без повторных объяснений.
Чем скилл отличается от обычного промпта или CLAUDE.md?
CLAUDE.md грузится в каждую сессию целиком и держит правила «всегда делай так». Скилл грузится по требованию: в контексте с самого начала висит только его короткое описание, а полное содержимое подтягивается, когда задача действительно подходит. Поэтому скиллов может быть много, и они не раздувают контекст.
Как добавить скилл в Claude Code?
Создай папку ~/.claude/skills/имя-скилла (личный, для всех проектов) или .claude/skills/имя-скилла (в репозитории проекта) и положи туда файл SKILL.md. Изменения видны сразу. Готовые скиллы ставятся из маркетплейса командой /plugin install.
Как установить скилл в Claude.ai?
В веб-версии зайди в Настройки → Capabilities (Возможности), нажми загрузку скилла и выбери файл SKILL.md. Скилл станет доступен в твоём профиле. Загрузка кастомных скиллов доступна на платных планах.
Скиллы для Claude бесплатные?
Сам механизм скиллов бесплатный — это просто markdown-файлы, за них никто не берёт денег. Платной может быть сама подписка Claude, по которой ты работаешь. Готовые скиллы из репозитория Anthropic тоже открытые и бесплатные.
Где взять готовые скиллы?
Официальный репозиторий — github.com/anthropics/skills: там примеры по категориям (дизайн, разработка, документы docx/pptx/xlsx/pdf) и шаблон для своего скилла. Плюс маркетплейс плагинов Anthropic, откуда скиллы ставятся одной командой.
Чем скилл отличается от MCP?
MCP подключает внешние сервисы и инструменты — базу данных, Slack, браузер. Скилл — это знания и процедуры для самого Claude, без внешних подключений. Они дополняют друг друга: MCP даёт инструмент, скилл учит Claude им правильно пользоваться.

Главное

Если коротко

Скилл — папка с файлом SKILL.md: сверху описание (когда применять), ниже инструкции (что делать). Claude грузит его по требованию — пока не пригодился, в контексте только описание, поэтому скиллов может быть сколько угодно. Создаёшь за минуту: mkdir + файл в ~/.claude/skills/. Ставишь готовые из anthropics/skills или маркетплейса. Секрет рабочего скилла — сильное description с ключевым сценарием в начале.

Официальные примеры и шаблон скилла — в репозитории anthropics/skills. Начни с готового, потом сделай свой под свой воркфлоу.

Больше про нейросети и автоматизацию в Telegram — «Digital-трафик»

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

Все статьи
Ссылка скопирована