Навыки: научите Cowork работать по-вашему

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

Что такое навык

Навык (Skill) — это папка с инструкцией и вспомогательными материалами, которая учит Claude делать определённый тип работы определённым образом. Ключевое слово — «тип работы»: не одна задача, а класс задач. «Собрать релиз-ноты», «оформить статус-отчёт», «переименовать макеты по нашей схеме».

Главное свойство навыка — Claude выбирает его сам. В начале сессии он видит короткие описания всех включённых навыков; когда задача подходит под описание, он читает навык целиком и следует ему. Вы можете вызвать навык и явно — через / и имя навыка в поле ввода, — но обычно достаточно описать задачу.

Это отличает навык от глобальных инструкций, которые Claude носит с собой в каждую сессию целиком. Инструкции навыка загружаются только когда нужны, поэтому навык может быть длинным и подробным, не утяжеляя остальные задачи.

Навыки — открытый формат: их поддерживают приложение Claude, Cowork, Claude Code и API, а спецификация опубликована на agentskills.io. Встроенные навыки для работы с Word, Excel, PowerPoint и PDF уже есть у Claude «из коробки» — именно они отвечают за то, что результат сохраняется как настоящий документ, а не текст в чате.

Из чего состоит навык

В обучающих материалах Anthropic навык описывают через четыре составляющие.

Инструкции — SKILL.md. Обязательный файл. Что навык делает, когда его применять, как выполнять работу шаг за шагом. Писать нужно так, чтобы по инструкции мог работать новый сотрудник.

Ассеты. Материалы, без которых результат не будет выглядеть как надо: шаблон презентации, логотип, шрифты, шаблон документа.

Референсы. Примеры хорошей работы: прошлые релиз-ноты, которые клиенту понравились, стайлгайд, глоссарий. Они задают планку качества, к которой Claude подтягивается.

Скрипты. Код для тех частей процесса, которые должны выполняться одинаково каждый раз: расчёты, сравнения, переименование по шаблону. Там, где нужна точность, скрипт надёжнее, чем просьба «посчитай».

Простой навык — это один файл SKILL.md. Сложный — папка с подпапками для ассетов, референсов и скриптов, на которые SKILL.md ссылается.

Формат SKILL.md

Файл состоит из двух частей: короткого блока метаданных в начале (YAML между строками ---) и обычного Markdown с инструкциями. В метаданных два обязательных поля: name (имя) и description (описание). Описание — самое важное поле в навыке: именно по нему Claude решает, применять ли навык. В нём должно быть и что навык делает, и когда его использовать, желательно теми словами, которыми вы формулируете задачу.

Вот навык для релиз-нот из урока о задачах:

---
name: release-notes
description: Собирает релиз-ноты для клиента из списка закрытых задач спринта по стандарту Amiga. Использовать, когда просят подготовить релиз-ноты, описание релиза, changelog или «что вошло в версию».
---

# Релиз-ноты по стандарту Amiga

## Входные данные
Список задач спринта: экспорт из трекера (CSV/Markdown) в рабочей
папке или задачи через коннектор. Если источник не указан — спросить.

## Что исключить
- Задачи с меткой `internal` или в проекте «Инфраструктура».
- Задачи не в статусе «Готово».

## Структура результата
Файл `release-notes-<номер спринта>.md`:
1. **Новое** — новые возможности, языком пользователя.
2. **Исправлено** — что перестало ломаться, с точки зрения пользователя.
3. **Изменилось** — изменения существующего поведения; обязательно,
   если пользователю придётся действовать иначе.
4. **Для команды** — технические детали, номера задач, миграции.

## Правила текста
- Заголовок задачи из трекера — не заголовок пункта. Переписать
  для пользователя: не «починил NPE в корзине», а «исправлена ошибка
  при оформлении заказа с пустой корзиной».
- Без внутренних номеров задач в разделах 1–3.
- Если из задачи непонятно, что изменилось для пользователя, —
  пункт в раздел «Требует уточнения» в конце файла, не угадывать.

## Пример
Образец хороших релиз-нот — `examples/release-notes-good.md`.
Придерживаться его тона и длины пунктов.

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

Ограничения на длину имени и описания, а также требования к структуре архива для загрузки, смотрите в документации по созданию навыков: они могут отличаться между Cowork и Claude Code.

Три способа создать навык

Попросить Claude. Самый простой путь. В Cowork начинаете задачу: «Создай навык для сборки релиз-нот по нашему стандарту». Claude задаёт вопросы — что на входе, когда применять, что считать хорошим результатом, какие материалы нужны — и собирает папку навыка. Дайте ему настоящие примеры: прошлые релиз-ноты, шаблон, экспорт задач. Результат появится в списке навыков в разделе настроек (в приложении он называется вроде «Customize» → «Skills»; название уточните в интерфейсе).

Записать процесс. В документации описана возможность записать, как вы делаете работу на экране, и получить навык из записи. Доступность этой функции зависит от платформы и тарифа — проверьте.

Написать руками. Создать папку, SKILL.md, добавить ассеты и примеры, упаковать и загрузить через настройки. Для Claude Code навык кладут в папку ~/.claude/skills/<имя>/ (личный) или .claude/skills/<имя>/ в проекте (командный); загружать ничего не нужно. Подробнее — в документации Claude Code.

Какой бы способ вы ни выбрали, дальше — проверка: запустите две-три реальные задачи, посмотрите, подхватил ли Claude навык и стал ли результат лучше, чем без него. Об этой проверке — урок «Проверка навыков и плагинов».

Навык, инструкции или проект?

Три инструмента легко перепутать, поэтому повторим границы.

Глобальные инструкции — о вас, читаются всегда, короткие. Проект — о конкретном потоке работы, со своими файлами и памятью. Навык — о том, как делать тип работы, читается когда нужен, может быть длинным и содержать материалы.

Навык «релиз-ноты» применится в любом проекте, где вы попросите релиз-ноты. Инструкция проекта «у этого клиента релиз-ноты на английском» уточнит его для одного клиента. А глобальная инструкция «без восклицательных знаков» будет действовать поверх обоих.

Что делает навык хорошим

Из практики Anthropic и нашей: один навык — одна работа, не «всё для менеджера». Описание с ключевыми словами, которыми вы формулируете задачу. Место для сомнений вместо угадывания. Настоящие примеры результата в папке навыка. И короткий SKILL.md: если он разрастается, выносите подробности в отдельные файлы и ссылайтесь на них.