Навыки: как научить Claude вашим стандартам

Инструкции проекта решают проблему повторяющегося контекста внутри одного проекта. Но есть правила, которые нужны везде: как мы оформляем документы, как пишем письма клиентам, какой структуры придерживаемся в отчётах. Переносить их в каждый проект — неудобно, держать в памяти — ненадёжно. Для этого есть навыки. После урока вы будете понимать, как они работают, и сможете написать первый навык для своей команды.

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

Навык (Skill) — это набор инструкций, оформленный как папка с файлом SKILL.md и, при необходимости, вспомогательными файлами: шаблонами, примерами, скриптами. Главное свойство навыка — Claude применяет его сам. Вы не пишете «используй навык оформления документов»; вы просите «подготовь коммерческое предложение», и Claude, увидев, что задача подходит под описание навыка, читает его инструкции и следует им.

Механика такая. В начале работы Claude видит только короткие описания всех включённых навыков — одну-две строки про каждый: что он делает и когда применяется. Когда запрос подходит под описание, Claude открывает полный текст навыка и работает по нему. Поэтому описание — самая важная часть: по нему модель решает, нужен навык или нет.

Навыки доступны на всех планах. Для их работы должен быть включён режим выполнения кода и создания файлов — навыки часто создают документы, и им нужна среда, где это возможно.

Встроенные навыки

Часть навыков уже есть в Claude и работает без настройки. Это навыки для создания файлов в офисных форматах:

• Word — документы с заголовками, таблицами, оглавлением.
• Excel — таблицы с формулами, а не с посчитанными значениями.
• PowerPoint — презентации со слайдами и заметками.
• PDF — создание и обработка.

Попросите «оформи это как документ Word с оглавлением» или «собери презентацию на восемь слайдов по этому плану», и Claude применит соответствующий навык. Результат — файл на скачивание. Качество оформления по умолчанию — аккуратное, но нейтральное; чтобы оно стало «нашим», нужен свой навык.

Свой навык: фирменный стиль документов

Разберём пример, полезный всей Amiga: навык, который заставляет Claude оформлять документы по стандарту агентства. Файл SKILL.md выглядит так:

---
name: amiga-docs
description: Оформление документов Amiga (КП, ТЗ, отчёты, протоколы) по фирменному стандарту. Применяй, когда просят подготовить, оформить или переписать документ для клиента или внутренний документ агентства.
---

# Документы Amiga

## Структура
- Первая страница: название документа, клиент, дата, версия, автор.
- Раздел «Кратко» в начале любого документа длиннее двух страниц: 3–5 предложений.
- Заголовки — только два уровня. Нумерация разделов: 1, 1.1.
- Таблицы — для сравнений и перечней с атрибутами; списки — для всего остального.

## Язык
- На «вы», без восклицаний и маркетинговых оборотов.
- Термины из глоссария в файле glossary.md; новые термины помечать.
- Сроки и суммы — только из исходных данных. Если их нет, писать «уточняется».

## Оформление файла
- Шрифт и цвета — по шаблону в template.docx.
- В футере каждой страницы: «Amiga · amiga.ru · <название документа>».

## Проверка перед выдачей
- Все разделы из шаблона на месте.
- Нет выдуманных цифр и дат.
- Раздел «Кратко» действительно краток.

В папке рядом с SKILL.md лежат glossary.md и template.docx. Папка упаковывается в ZIP и загружается в настройках навыков. После этого любая просьба «подготовь КП», «оформи протокол встречи», «перепиши этот отчёт для клиента» автоматически пройдёт через эти правила.

Обратите внимание на описание: в нём перечислены и типы документов, и глаголы («подготовить, оформить, переписать»). Это то, по чему Claude узнаёт задачу. Если описание расплывчатое («помогает с документами»), навык будет срабатывать через раз.

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

Три механизма часто путают. Различие в области действия и в том, кто инициирует.

Инструкции проекта действуют всегда, но только внутри проекта. Они про контекст: кто вы, какой продукт, какие правила именно здесь.

Навык действует везде, но только когда задача подходит. Он про процедуру: как делать определённый тип работы. Один навык — один тип задачи.

Память — то, что Claude сам накопил о вас. Она про предпочтения и факты, а не про правила, и на неё нельзя полагаться как на стандарт: она может не сработать, и её нельзя раздать команде.

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

Навыки для команды

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

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

Как проверить, что навык работает

Написали навык — проверьте его так же, как тест.

1. Задайте три-четыре запроса, которые должны его запустить («подготовь КП на разработку сайта», «оформи протокол встречи из этих заметок»). Убедитесь, что Claude сообщает о применении навыка и результат соответствует правилам.
2. Задайте два запроса, которые не должны его запускать («напиши письмо с напоминанием о встрече»). Если навык срабатывает — описание слишком широкое.
3. Найдите правило, которое нарушается чаще всего, и переформулируйте его жёстче или перенесите в начало.

Устройство навыков глубже — файлы, скрипты, что можно и нельзя, как навыки работают в Claude Code — разбирается в курсе «Навыки». Здесь достаточно уметь написать простой навык из одного файла и понять, когда он нужен.