Концептуальный обзор · что это и зачем

Claude Skills — модульная экспертиза, которая подгружается по требованию.

Skills — это папка с инструкциями (и опционально кодом/ресурсами), которую Claude загружает только тогда, когда она нужна для задачи. Не промт. Не MCP. Не Project knowledge. Отдельный слой, который решает свою задачу — упаковка повторяемых процедур и доменной экспертизы.

Формат

SKILL.md + папка

Загрузка

Прогрессивная

Лимит SKILL.md

~500 строк

Стандарт

agentskills.io

TL;DR
01 / 08

Skill — это упакованная процедура: «как делать конкретную вещь правильно, по нашим правилам, со всеми граблями».

Claude видит только метаданные (name + description) всех скилов в системном промте. Полный SKILL.md грузится в контекст только тогда, когда Claude решил, что скил применим к текущей задаче. Это и есть «progressive disclosure» — главная фишка.

Ментальная модель

Skills — это не промт и не MCP. У каждого слоя своя роль.

Промт

Одноразовая инструкция в чате. Действует на один разговор, не переиспользуется автоматически.

Когда: разовая задача, эксперимент

Project knowledge

Статичный контекст, который грузится в начало каждого чата проекта. Background, всегда подключён.

Когда: общий контекст компании, гайды

03 · СКИЛЫ

Skills

Процедурное знание. Грузится по требованию, только когда Claude видит совпадение по описанию. Не засоряет контекст.

Когда: повторяемый workflow, специализация

MCP

Подключение к внешним сервисам и API (Notion, Slack, БД). Скилы могут учить Claude правильно ими пользоваться.

Когда: нужны действия во внешних системах

«Projects = что Claude всегда знает. Skills = как Claude делает конкретную работу. MCP = куда Claude может дотянуться.» — три разных слоя, не заменяют друг друга

Как это работает — три уровня подгрузки

progressive disclosure

Главная инженерная идея Skills — модель не держит в контексте всё подряд. Она достаёт ровно столько, сколько нужно для текущей задачи. Три уровня:

01

          Метаданные
          name + description
        

          Claude видит только короткое описание скила в системном промте. По нему решает,
          применим ли скил к запросу пользователя.
        
~50 токенов
02

          Тело SKILL.md
          основные инструкции
        

          Если скил подходит — Claude читает весь SKILL.md в контекст. Это инструкции,
          правила, чек-листы. Не больше 500 строк по best practices.
        
~500–3000
03

          Дополнительные файлы
          references/, scripts/, templates/
        

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

«Объём контекста, который можно упаковать в скил, фактически неограничен — потому что Claude грузит только нужные секции, а не всё разом.» — инженерный блог Anthropic

Устройство SKILL.md

Два главных поля решают всё: name и description.

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

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

name: Lowercase, через дефис, короткое. Например: pdf-form-filler
description: Главное поле. Что делает + когда применять. Это то, по чему Claude решает использовать скил.
Тело .md: Инструкции, чек-листы, примеры. Структурированный markdown — заголовки, списки, код.
Папки: references/, scripts/, templates/ — догружаются опционально.

            SKILL.md · базовая структура
            
          
---
name: brand-voice-rewriter
description: Rewrites any text into the
  founder's voice. Use whenever
  the user says "in my style",
  "по моему голосу", "human voice"
  or attaches a draft to be reworked.
---

# Brand Voice Rewriter

## Когда применять
- запрос содержит «в моём стиле»
- пользователь даёт черновик
- просьба «human voice»

## Правила переписывания
1. Убрать длинные тире
2. Не использовать формулы X × Y × Z
3. Один маркер на 200 слов
4. Лексика: «штука», «прикол в том»
5. Концовка через «Это я к чему»

## См. также
- references/full-voice-guide.md
- references/banned-phrases.md
- examples/before-after.md

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

Шесть типовых ситуаций, где скил окупается

Скил имеет смысл там, где есть повторяемость + специфические правила, которые Claude по умолчанию не знает. Если задача разовая или общеизвестная — скил избыточен.

Бренд / голос

Стилистика автора или компании

Как пишет основатель, какие слова запрещены, какой ритмики держаться. Без скила Claude сваливается в дефолтную AI-речь.

пример brand-voice · human-voice · tone-of-voice-checker

Документы

Создание форматных артефактов

Word, Excel, PPT, PDF, Notion-страницы по корпоративному шаблону. Anthropic поставляет такие скилы из коробки.

пример docx · pptx · xlsx · pdf · brand-deck-builder

Воркфлоу

Многошаговые процедуры

Где порядок шагов и чек-листы критичны. Деплой, ревью, онбординг клиента, обработка встречи в KB.

пример meetings-kb-pipeline · pr-review · client-onboarding

Доменные правила

API-конвенции и codebase guidelines

Правила именования, паттерны ошибок, специфика стека. Модель применяет их сама, не нужно повторять в каждом чате.

пример api-conventions · db-migration-rules · ui-tokens

MCP-обвязка

Как правильно пользоваться внешним инструментом

MCP даёт доступ к Notion/Jira/Sentry. Скил учит, в каком порядке и по каким правилам там работать. Реальный пример — sentry-code-review.

пример sentry-code-review · notion-pages-pipeline

Команды и /-shortcuts

Прямые команды для пользователя

Скилы с disable-model-invocation: true можно дёргать только вручную через слэш-команду. Полезно для деплоев и других действий с побочными эффектами.

пример /deploy · /commit · /summarize-changes

Готовые скилы Anthropic

Что уже есть из коробки — и как Claude их триггерит

Anthropic выложила в open-source 17 скилов в репозитории anthropics/skills. Часть из них автоматически работает в Claude.ai при создании файлов. Вот ключевые — и по каким триггерам Claude их подгружает.

Скил	Что делает	Триггеры в запросе	Содержит код
docx	Создание и редактирование Word-документов с форматированием, таблицами, заголовками	«сделай word doc», «отчёт в .docx», «составь письмо»	Python-скрипты для манипуляций
pptx	Презентации со слайдами, темами, графикой — продакшн-качество	«сделай презентацию», «deck», «слайды по этой теме»	Templates + python-pptx
xlsx	Excel-таблицы с формулами, диаграммами, форматированием, финмодели	«в excel», «.xlsx», «финмодель», «таблица с подсчётом»	openpyxl / Python
pdf	Заполнение PDF-форм, мерж, сплит, OCR сканов, извлечение таблиц	«заполни pdf», «объедини PDF», «извлеки текст из PDF»	Полный python-стек для PDF
frontend-design	UI-компоненты с правильными design tokens и стилем (Claude artifacts)	«сделай лендинг», «React-компонент», «свёрстай страницу»	Reference-файлы по стилю
skill-creator	Скил, который создаёт другие скилы. Помогает структурировать, тестировать, оптимизировать описание	«создай скил», «оптимизируй SKILL.md», «протестируй скил»	Eval-фреймворк, run_loop
sentry-code-review	MCP-обвязка: автоматически разбирает баги из Sentry и фиксит их в PR на GitHub	«разбери ошибку из Sentry», «check PR with sentry data»	+ MCP Sentry connector

«Скил docx — это не «знание про Word». Это упакованный набор правил: какие шрифты, какие отступы, как делать TOC, как вставлять картинки без поломок. Claude следует им вместо угадывания.» — зачем нужны даже «очевидные» скилы

Best practices vs anti-patterns

Как делать скилы правильно — и чего избегать.

✓ Что работает

Принципы из реальной практики

Один скил = одна задача. Узкая специализация лучше широкого «делай всё»
Description — для модели. Включай ключевые слова, форматы файлов, прямые формулировки запросов
500 строк — потолок SKILL.md. Дальше — выноси в references/
Прогрессивная структура. Базовое в SKILL.md, детали в отдельных файлах, скрипты в scripts/
Eval перед публикацией. Тестируй на 10–20 запросах: триггерится скил или нет, помогает или мешает
Итерация с самим Claude. Просить модель отрефлексировать, что пошло не так — она подскажет, какого контекста не хватило

✕ Чего избегать

Типичные ошибки

Расплывчатое description. «Помогает писать» — никогда не подгрузится в нужный момент
Скил-монолит. SKILL.md на 2000 строк — Claude утонет, контекст распухнет
Дублирование с Project knowledge. Если это «всегда нужно» — это не скил, это Projects
Скил вместо промта. Разовая задача — просто промт, не заводи папку
Слишком общие триггеры. Description «работа с текстом» — подгрузится на каждый чих
Side-effect без disable-model-invocation. /deploy не должен запускаться сам — только по команде

С чего начать

Три шага, чтобы завести первый скил сегодня

Найди узкое место

Какая инструкция повторяется в каждом втором чате? Какое правило ты постоянно объясняешь Claude заново? Это кандидат на скил.

Напиши SKILL.md

Папка skill-name/, внутри SKILL.md с YAML-фронтматтером. Описание — конкретные триггеры. Тело — пронумерованные правила.

Загрузи и проверь

В Claude.ai: Settings → Capabilities → Skills (zip). В Claude Code: ~/.claude/skills/. Прогони 10 тестовых запросов — триггерится или нет.

«Скилы — это design pattern, а не фича. Большинство относятся к ним как к markdown-файлам с инструкциями. Это правда наполовину — нормально для PoC, но для прод-надёжности нужна структурная дисциплина.» — практик о скилах в продакшне