Что такое Skills (скиллы — переиспользуемые инструкции для Claude) — переиспользуемая экспертиза

Модуль: Skills — переиспользуемая экспертиза | Время: ~25 мин теории + 30 мин практики

Суть урока

Если воркфлоу (рабочий процесс) — это рецепт для одного конкретного блюда, то скилл — это рецепт с паспортом, который можно передать любому повару в любом ресторане мира. Скилл знает кто он, что умеет, и умеет представиться агенту (агент — автономный исполнитель задач), который его никогда не видел.

Ключевые концепции

• Скилл = воркфлоу + YAML (ямл — формат конфигурационных файлов) паспорт (frontmatter — фронтматтер, метаданные в начале файла)
• Прогрессивная загрузка: L1 frontmatter → L2 полный воркфлоу → L3 файлы
• Установка готовых скиллов через /plugin из marketplace, свои скиллы — папкой .claude/skills/<имя>/SKILL.md
• 6-шаговый фреймворк создания скилла
• Скиллы улучшаются через итерацию и обратную связь

Теория

Воркфлоу vs Скилл — в чём разница

🎨 Образ: скилл — это рецепт в поваренной книге. Воркфлоу — это блюдо которое ты приготовил сегодня по памяти. Блюдо исчезнет. Рецепт останется — и любой повар в любом ресторане воспроизведёт его завтра.

Воркфлоу — это последовательность шагов для конкретной задачи. Живёт в памяти текущей сессии. Исчезает когда закрываешь вкладку.

Скилл — это тот же воркфлоу, но упакованный в файл с метаданными. Файл называется SKILL.md и лежит в папке скилла (.claude/skills/<имя>/SKILL.md):

---
name: weekly-youtube-roundup
description: Анализирует YouTube канал за 7 дней и генерирует отчёт. Используй, когда просят недельную сводку по каналу.
---

# YouTube Weekly Roundup

## Шаг 1: Сбор данных...

У frontmatter есть и другие необязательные поля (например allowed-tools, model, disable-model-invocation), но обязательно главное — description: по нему Claude решает, когда подключить скилл.

Разница критическая:

• Воркфлоу знает только агент в текущей сессии
• Скилл знает любой агент — он может прочитать frontmatter и понять "о, это для YouTube аналитики"

Как агент выбирает нужный скилл — прогрессивная загрузка

Представь: у тебя 50 скиллов. Загружать все 50 в контекст (контекст — текст видимый AI) при каждом запросе = тысячи токенов (токен — единица текста для AI) впустую. Поэтому используется прогрессивная загрузка — три уровня:

🎨 Образ: прогрессивная загрузка — как библиотека. Сначала ты смотришь на корешки (L1 — frontmatter, секунды). Нашёл нужную — берёшь с полки и читаешь (L2 — полный воркфлоу). Только если нужен приложенный атлас — открываешь отдельно (L3 — reference файлы). Не тащишь сразу весь стеллаж.

L1: Frontmatter (порядка сотни токенов на скилл)

Агент читает только заголовочную часть всех скиллов: название и описание. Это как читать корешки книг на полке — видишь название и краткое описание. По ним определяет: "вот этот скилл подходит для задачи". Описание в списке ограничено по длине (в документации на октябрь 2026 — около 1 500 знаков), поэтому главное пиши в начале.

name: weekly-youtube-roundup
description: Анализирует YouTube канал за 7 дней и генерирует отчёт

L2: Полный markdown воркфлоу (1000–2000 токенов)

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

L3: Вспомогательные файлы (по необходимости)

Если скилл ссылается на файлы — brand guidelines, шаблон отчёта, список конкурентов — они загружаются только если нужны для выполнения. Если задача не требует брендинга — файл брендинга не загружается. Рядом с SKILL.md в папке скилла можно держать такие файлы и скрипты.

Итог: вместо загрузки 50 × 2000 токенов = 100,000 токенов на каждый запрос — только frontmatter скиллов (50 × 100 = 5,000) + полный текст выбранного (2,000). Цифры иллюстрация, но порядок экономии такой: в разы.

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

Шаг 1: В Claude Code напиши:

/plugin

Откроется меню плагинов с каталогами (marketplace). Скиллы распространяются в составе плагинов. Посмотреть, какие скиллы уже доступны, можно командой /skills.

Шаг 2: Найди нужный скилл. Примеры названий плагинов в каталогах:

• engineering:* — разработка, review, деплой
• marketing:* — контент, email, SEO
• superpowers:* — продуктивность, параллельная работа
• anthropic-skills:* — официальные скиллы Anthropic

Шаг 3: Установи (точное имя плагина и каталога покажет меню /plugin):

/plugin install <плагин>@<каталог>

Скиллы плагина становятся доступны агенту сразу или после /reload-plugins. Вызвать их можно вручную как /плагин:скилл, но чаще агент сам подхватывает нужный по описанию.

Шаг 4: Используй:

Сделай code review этого файла

Агент распознает по описанию, что нужен скилл для code review, и применит его.

Скиллы улучшаются со временем

Скилл — не статичный документ. Он эволюционирует:

1. Первая версия: создал, запустил, получил результат
2. Заметил проблему: "отчёт слишком длинный, нет executive summary"
3. Итерация: добавил шаг с executive summary в frontmatter + воркфлоу
4. Снова запустил: лучше
5. Следующая проблема: "конкурентный бенчмаркинг не учитывает мой регион"
6. Итерация 2: добавил параметр региона

К 10-30 итерации скилл становится точно настроенным инструментом под твои задачи. Это и есть "encoded expertise" — экспертиза закодирована в файл.

🎨 Образ: итерация скилла — как заточка ножа. После первого использования уже режет. После десятого — бреет. После тридцатого — это хирургический инструмент. Каждая правка убирает заусенец который мешал.

6-шаговый фреймворк создания скилла

Шаг 1: Имя и триггер

Как агент поймёт что нужно использовать этот скилл? Отдельного поля triggers нет: фразы-триггеры пишутся прямо в description (или в необязательное поле when_to_use).

name: competitor-price-monitor
description: >
  Мониторит цены конкурентов и генерирует сравнительный отчёт.
  Используй, когда просят "проверь цены конкурентов",
  "competitor pricing" или "price monitoring".

Шаг 2: Цель — одна чёткая фраза

"Собрать цены с 10 сайтов конкурентов, сравнить с нашими ценами, подсветить отклонения >15%."

Не "делает всё про конкурентов". Один фокус.

Шаг 3: Пошаговый процесс

Детальные инструкции каждого шага. Не "собери данные" — а "открой URL, найди элемент .price-tag, извлеки текст, конвертируй в число".

Шаг 4: Reference файлы

Что нужно скиллу кроме инструкций? Такие файлы кладутся в папку скилла рядом с SKILL.md, а в тексте скилла на них даётся ссылка:

competitor-price-monitor/
  SKILL.md
  competitors.json       # список URL конкурентов
  price-template.md      # шаблон отчёта
  brand-guidelines.md    # для форматирования

В SKILL.md пишешь: "Список конкурентов лежит в competitors.json в этой же папке". Claude откроет файл, когда он понадобится.

Шаг 5: Правила и ограничения

Что скилл НЕ должен делать:

- Не изменять исходные данные в базе
- Не отправлять отчёт без проверки
- При ошибке парсинга — пропустить сайт и пометить как недоступный

🎨 Образ: 6-шаговый фреймворк — как техническое задание для нового сотрудника. Имя (кто ты), цель (зачем нанят), процесс (как работаешь), инструменты (что берёшь со склада), ограничения (что нельзя), обратная связь (как отчитываешься). Пропусти один шаг — сотрудник либо ничего не делает, либо делает не то.

Шаг 6: Петля самосовершенствования

В конце скилла — инструкция агенту:

После выполнения оцени качество результата 1-10.
Если < 7 — опиши что пошло не так в файл skill-feedback.md.

Это создаёт систему обратной связи для дальнейших улучшений.

Частые ошибки при создании скиллов

1. Скилл слишком широкий. "Скилл для маркетинга" — плохо. "Скилл для создания email-рассылки с A/B тестированием заголовков" — хорошо. Один скилл = один фокус.

2. Забыть YAML frontmatter. Без frontmatter с description агенту нечем понять, когда подключать скилл. Всегда начинай с --- блока и хорошего описания.

3. Пихать все данные в тело скилла. Список из 200 конкурентов в теле скилла = 200 строк которые загружаются каждый раз. Выноси большие данные в отдельные файлы рядом со SKILL.md. Рекомендация из документации Claude Code: держи SKILL.md короче 500 строк.

4. Не описать триггеры. Если в description не написано, когда использовать скилл, — он может не активироваться на нужный запрос.

5. Не итерировать. Первая версия скилла почти никогда не идеальна. Plan: создать → запустить → увидеть слабость → исправить → повторить.

Skills vs Hooks (хуки — скрипты реагирующие на событие) vs Agents (агенты — автономные исполнители) — в чём разница

Реальный YAML frontmatter скилла

---
name: weekly-competitor-report
description: >
  Еженедельный отчёт по конкурентам: цены, новые продукты,
  изменения на сайтах. Формат: executive summary + таблица.
  Используй, когда просят "отчёт по конкурентам",
  "что нового у конкурентов", "competitor report"
  или "мониторинг конкурентов".
argument-hint: "[pricing|features|content]"
---

# Отчёт по конкурентам

Список сайтов лежит в competitors.json в этой папке,
шаблон отчёта — в report-template.md.
На что обращать внимание: $ARGUMENTS (по умолчанию — цены).

В этом примере параметр передаётся при вызове (/weekly-competitor-report features) и подставляется в текст как $ARGUMENTS. Поля tags, triggers, references, parameters и model_invocation, которые встречались в старых описаниях скиллов, в Claude Code не используются: триггеры живут в description, а справочные файлы лежат рядом в папке скилла.

Документация по скиллам Claude Code: https://code.claude.com/docs/en/skills

Где хранить скиллы

🎨 Образ: глобальные скиллы — как твой личный набор инструментов который ты носишь с собой. Проектные скиллы — как специнструмент который остаётся на конкретном объекте. Перфоратор всегда с тобой, а опалубка — только на этой стройке.

Глобально (~/.claude/skills/<имя>/SKILL.md): Скилл доступен из любого проекта. Подходит для универсальных скиллов: code review, email writing, price monitoring.

На уровне проекта (.claude/skills/<имя>/SKILL.md): Скилл доступен только в этом проекте. Подходит для специфических скиллов: "наш формат отчётов", "бренд-голос конкретного клиента". Папку проекта можно закоммитить, и скилл появится у всей команды.

Что ещё полезно знать (на октябрь 2026):

• Старые пользовательские команды из .claude/commands/ продолжают работать и объединены со скиллами: файл .claude/commands/deploy.md и скилл .claude/skills/deploy/SKILL.md оба создают команду /deploy. Для нового лучше выбирать скиллы
• Скиллы доступны и в claude.ai, включая бесплатный тариф. Для загрузки туда во frontmatter допустимы только общие поля (name, description, license, compatibility, metadata, allowed-tools), поля, специфичные для Claude Code, при загрузке дадут ошибку

Практика

Задание: Найти и установить 2-3 скилла из marketplace

1. Открой Claude Code и напиши /plugin
2. Изучи каталог — найди минимум 3 скилла которые потенциально полезны для твоих задач
3. Установи 2 скилла: один для рабочих задач (разработка или маркетинг), один для продуктивности
4. Запусти /skills и посмотри список — найди установленные скиллы, открой файл SKILL.md и прочитай frontmatter
5. Попробуй использовать один скилл на реальной задаче
6. Бонус: создай простой скилл вручную — "шаблон ежедневного отчёта" — по 6-шаговому фреймворку

Инструменты и ресурсы

• /plugin — команда для открытия меню плагинов и каталогов (marketplace) в Claude Code
• /skills — список доступных скиллов
• Claude Code Skills документация — официальная документация по скиллам
• Claude Code Sub-agents — документация по суб-агентам (связано)
• .claude/skills/<имя>/SKILL.md — скилл на уровне проекта
• ~/.claude/skills/<имя>/SKILL.md — глобальный скилл

Ключевые выводы

Скилл = воркфлоу с паспортом. Паспорт позволяет любому агенту найти и использовать скилл без ручного объяснения.

Прогрессивная загрузка экономит львиную долю токенов: сначала читаем корешки книг (frontmatter), потом открываем нужную (полный markdown).

Скиллы улучшаются через итерацию. Версия 1 — черновик. Версия 15 — точный инструмент под твои задачи.

Связанные уроки

• → Создаём скилл с нуля LIVE — практическое создание скилла через Skill Creator с eval framework
• → Архитектура скиллов — два архетипа: Capability Uplift vs Encoded Preference
• → Evals — самоулучшающиеся скиллы — система тестирования скиллов для самоулучшения

Следующий урок

→ Создаём скилл с нуля LIVE: Skill Creator + Eval Framework