Agent Skills: как научить AI работать по-вашему. Часть 1

Повторять одни и те же требования в каждом разговоре неудобно: формат, порядок действий, критерии качества снова занимают контекст. Agent Skills (навыки агента) позволяют сохранить такую процедуру в отдельном файле и загружать её, когда задача подходит по смыслу.

Собственно, я прошла курс Introduction to Agent Skills от Anthropic Academy и, наконец, систематизировала то, что до этого делала на интуиции. Конспект перед вами: мои заметки, мои примеры, мой опыт. Не перевод, а осмыслённая выжимка.

Это часть 1 из 2. Здесь разбираю основы: что такое скиллы, чем отличаются от других инструментов, как создать первый. Часть 2: продвинутая настройка, распространение и отладка →

Это часть серии «Учусь вместо вас». Также в серии: Claude 101, AI Fluency for Educators, Advanced Prompt Engineering и Claude Code in Action.

Курс: Introduction to Agent Skills Платформа: Anthropic Academy (anthropic.skilljar.com) Ссылка: anthropic.skilljar.com/introduction-to-agent-skills Длительность: ~2.5 часа (10 видеоуроков + тест) Язык: English Бесплатно, с сертификатом Авторский конспект по материалам курса. Не является официальным переводом или публикацией Anthropic.

Сертификат Introduction to Agent Skills — Валерия Ом

Что такое Agent Skills и почему это важнее промптов?

Есть хорошая аналогия. Промпт (одноразовый запрос к AI) работает как заказ еды в ресторане: описываете, что хотите, ждёте, получаете результат. Иногда угадали, иногда нет. А скилл (Skill) работает иначе: вы научили кого-то готовить ваше любимое блюдо. Один раз объяснили рецепт, и дальше человек готовит его сам, каждый раз одинаково хорошо. Вам не нужно заново описывать ингредиенты и последовательность.

Зачем это не-разработчику? Допустим, вы регулярно готовите материалы в одном формате. Вместо того чтобы повторять структуру, тон и критерии проверки, их можно сохранить в skill и обновлять в одном месте.

Технически Skill представляет собой папку с файлом SKILL.md, где лежат метаданные и инструкции. Claude может выбрать skill по описанию задачи, а пользователь может вызвать его напрямую через /имя. Полные инструкции загружаются только при вызове.

Ключевая разница с обычным промптом в хранении и повторном использовании. Промпт относится к текущему разговору, а filesystem-based skill хранится в личной или проектной папке, версионируется и может использоваться в следующих сессиях.

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

В курсе формулируют так:

Если вы объясняете Claude одно и то же снова и снова, это скилл, который ждёт, чтобы его написали.

Это хороший первый тест. Если инструкция повторяется, проверьте, достаточно ли она стабильна и измерим ли результат. Если да, её можно оформить как skill.

Когда использовать CLAUDE.md, Skills, Hooks и MCP?

CLAUDE.md задаёт общие правила проекта, Skills хранят специализированные процедуры, Hooks автоматизируют проверки, а MCP подключает внешние сервисы. До курса это был для меня самый запутанный момент, но Anthropic расставляет всё по полочкам. Я перевела это в формат, который использую сама: таблицу решений.

Быстрый словарь терминов перед таблицей:

CLAUDE.md: текстовый файл с правилами проекта, который Claude читает автоматически при каждом запуске. Аналог должностной инструкции сотрудника.
Skills (скиллы): наборы инструкций, которые активируются только по запросу. Аналог справочника, который достаёте с полки, когда нужен.
Hooks (хуки): автоматические проверки, срабатывающие на определённые события. Сохранил файл, хук проверил форматирование. Без вашего участия.
MCP (Model Context Protocol): протокол для подключения внешних сервисов вроде Notion, Google Sheets, Telegram. Даёт AI «руки» для работы с другими программами.
Subagents (субагенты): отдельные AI-процессы, которые получают свою собственную изолированную задачу.

Мне нужно…	Использую	Почему
Задать правила для всех разговоров в проекте	CLAUDE.md	Загружается автоматически, всегда в контексте
Научить AI делать конкретную задачу	Skills	Загружается по запросу, не забивает контекст
Автоматически проверять код при сохранении	Hooks	Срабатывает на событие, а не на запрос
Подключить внешний сервис (Notion, Sheets)	MCP	Даёт инструменты, а не знания
Делегировать задачу в изолированном контексте	Subagents	Отдельный «мозг» со своим набором информации

Ключевая мысль из курса, которая всё упростила:

Skills добавляют знания (как делать), а MCP даёт инструменты (чем делать).

Скилл знает, как писать карточки для Instagram. MCP умеет публиковать их в Notion. Разные задачи.

Ещё одно отличие, которое стоит запомнить. CLAUDE.md загружается всегда, в каждом разговоре. Скилл загружается по ситуации. Соответственно, в CLAUDE.md кладёте общие правила проекта (стиль кода, структура, бренд), а в скиллы пишете специализированные процедуры: как генерировать карточки, как делать конспект, как проверять факты.

Типичная комбинация, которой я пользуюсь каждый день: CLAUDE.md (правила проекта) + Skills (специализация по задачам) + MCP (подключение к Notion и Google Sheets). До хуков я пока не добралась, но курс объяснил, зачем они нужны. Если скиллы отвечают за «знания по запросу», то хуки берут на себя «автоматические проверки на событиях». Сохранил файл, хук проверил форматирование. Вызвал команду, хук записал лог.

Как создать первый skill?

Для базового skill достаточно создать папку и файл SKILL.md. Скрипты не обязательны: первая версия может состоять только из описания и текстовых инструкций.

Шаг 1. Создайте папку.

Скиллы хранятся в двух местах:

~/.claude/skills/ (личные) работают во всех проектах, видите только вы
.claude/skills/ (проектные) приходят с репозиторием, видит вся команда

Для первого скилла берём личный путь:

mkdir -p ~/.claude/skills/blog-post-writer

Совет из курса: давайте skills описательные имена. Не writer, а blog-post-writer. Не review, а front-end-pr-review. Если имена совпадают, enterprise skill имеет приоритет над личным, а личный над проектным. Skills из плагинов используют пространство имён плагина.

Шаг 2. Создайте файл SKILL.md.

---
name: blog-post-writer
description: >
  Создаёт статьи для блога valeryom.com.
  Используй, когда просят написать пост, статью
  или черновик для блога.
---

## Инструкции

1. Формат: Markdown с YAML-frontmatter
2. Тональность: менторская, от первого лица
3. Обязательно: lead, 3-5 секций H2, FAQ, soft CTA
4. Внутренние ссылки: минимум 2 на другие статьи
5. Объём: 1500-2500 слов

Обратите внимание на description. Это самое важное поле. Claude использует именно описание для семантического сопоставления: он не ищет точные слова, а сравнивает смысл вашего запроса с описанием скилла. Если описание расплывчатое, скилл не будет срабатывать. Курс подчёркивает: хорошее описание отвечает на два вопроса. Что делает скилл и когда Claude должен его использовать. Максимум 1024 символа.

Шаг 3. Проверьте обнаружение skill.

Claude Code отслеживает изменения в существующих папках skills во время сессии. Перезапуск нужен, если верхнеуровневая папка skills не существовала при старте и была создана впервые.

Claude Code обнаруживает skills из нескольких источников:

Enterprise (managed settings): для корпоративных клиентов
Personal (~/.claude/skills/): ваши личные
Project (.claude/skills/ в репозитории): командные
Plugins: skills с пространством имён конкретного плагина

Шаг 4 (бонус). Усложняем.

Когда базовый скилл работает, можно добавить дополнительные поля в frontmatter:

---
name: blog-post-writer
description: Создаёт статьи для блога valeryom.com
allowed-tools: ["Read", "Grep", "Glob", "Write", "Edit"]
model: opus
---

Поле allowed-tools задаёт инструменты для skill при прямом использовании Claude Code CLI. Его не стоит считать полноценной песочницей: безопасность также зависит от общих разрешений, окружения и содержимого самой инструкции.

А если скилл разрастается, курс рекомендует принцип Progressive Disclosure (прогрессивное раскрытие), то есть разделение на файлы:

blog-post-writer/
├── SKILL.md          ← основное (до 500 строк)
├── scripts/          ← скрипты, которые выполняются
├── references/       ← дополнительная документация
└── assets/           ← шаблоны, данные

Файлы в scripts/ можно выполнять и передавать в контекст только их вывод, если полное содержимое скрипта не нужно для задачи. Поддерживающие файлы стоит явно описать в SKILL.md, чтобы Claude понимал, когда к ним обращаться.

Какие скиллы я создала и что они автоматизируют?

Я использую несколько skills для повторяющихся редакционных и технических задач. Их ценность не в количестве, а в том, что процедура и критерии проверки зафиксированы явно.

content-workflow хранит требования к форматам площадок, структуре материала и тону. Он помогает подготовить варианты, но не заменяет редакторское решение.

learning-notes задаёт каркас для конспектов из транскриптов: ключевые идеи, тематические секции, контрольные вопросы и глоссарий.

fact-checking описывает порядок проверки утверждений: выделить изменяемые факты, найти первоисточники, сопоставить даты и отметить то, что не удалось подтвердить. Сам skill не гарантирует точность без качественного поиска и ручной проверки.

seo-aeo-review помогает проверить метаданные, структуру заголовков, внутренние ссылки и FAQ перед публикацией.

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

Хороший skill не обещает автономную работу. Он уменьшает повторение инструкций и делает процесс удобнее для проверки и улучшения.

Кому подойдёт этот курс?

Если вы используете Claude Code хотя бы пару раз в неделю и замечаете, что повторяете одни и те же инструкции, вам нужны скиллы. Необязательно быть программистом. SKILL.md (файл с инструкциями для скилла) по сути обычный текстовый файл на Markdown. Если вы умеете написать инструкцию сотруднику, вы умеете написать скилл.

Если вы ещё не знакомы с Claude, начните с конспекта Claude 101 для общей картины. На момент моего прохождения курс и сертификат были бесплатными; актуальные условия лучше проверить на странице Anthropic Academy.

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

Серия «Учусь вместо вас»:

Часто задаваемые вопросы

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

Нет. SKILL.md представляет собой Markdown-файл с текстовыми инструкциями. Единственная техническая часть: создать папку и файл. Если вы работаете в Claude Code, вы это уже умеете. Скрипты и автоматизация, скажем так, опциональная надстройка для тех, кто хочет большего.

Чем скиллы отличаются от Projects в Claude?

Projects хранят контекст и документы внутри рабочего пространства. Skills содержат повторяемые инструкции и дополнительные ресурсы. Этот конспект сосредоточен на filesystem-based skills в Claude Code, хотя Agent Skills также существуют в других продуктах Anthropic.

Сколько скиллов можно создать?

Практическое ограничение важнее формального: большое количество похожих описаний усложняет выбор подходящего skill. Лучше хранить только актуальные процедуры, давать им различимые имена и регулярно пересматривать.

Что делать, если скилл не срабатывает?

Частая причина в описании: оно не объясняет, что делает skill и когда его использовать. Добавьте конкретные сценарии вызова, проверьте имя и frontmatter. Подробнее об отладке рассказываю в части 2.

Во второй части разбираю продвинутые темы: распространение skills в команде, запуск в изолированном контексте и последовательную диагностику ошибок.

Если вы уже используете Claude Code и хотите определить первые подходящие процессы для skills, это можно обсудить на консультации. Для общей картины также пригодятся конспект Claude Code in Action и статья про голосовой конвейер контента.