Skills для Claude: свой рабочий навык за пять шагов
Устройство SKILL.md, способы подключения, семь рабочих идей, тестирование и шесть ошибок. С готовым примером и промптом для сборки.
Каждую пятницу вы просите ИИ собрать отчёт, затем снова объясняете структуру и исправляете придуманные показатели. Повторяющийся порядок можно вынести в Skill: файл с правилами, примерами и нужными материалами. Это способ передать процесс помощнику, а не обещание безошибочной работы.
Промпт, проект и Skill
Промпт задаёт отдельную просьбу. Проект объединяет контекст связанных задач. Skill хранит повторяемый порядок выполнения и описание, по которому агент понимает, когда его подключать. В документации Anthropic используется поэтапная загрузка: сначала метаданные, затем подходящая инструкция, по необходимости дополнительные ресурсы.
Практический тест простой: можно ли описать действия и проверить результат? «Делай хороший маркетинг» слишком расплывчато. «Собери отчёт по этим колонкам, покажи отсутствующие значения и не делай прогноз без данных» уже задаёт проверяемую работу.
Где подключать
| Среда | Способ | Что учитывать |
|---|---|---|
| claude.ai | ZIP в Settings, раздел Features | Свои Skills доступны на Pro, Max, Ultra, Team и Enterprise при включённом выполнении кода |
| Claude Code | Папка навыка в личном или проектном каталоге skills | Проверять права инструментов и влияние на рабочие файлы |
| API | Skills API и подключение в контейнер выполнения | Нужно отдельно настроить инструмент исполнения и доступ приложения |
Способы установки различаются: не ожидайте, что ZIP из чата автоматически появится в другом продукте. В claude.ai пользовательские навыки индивидуальны; правила командной раздачи следует проверять для выбранной среды. Готовая обработка документов и собственный навык – разные варианты использования. Доступность тарифа и страны проверяйте перед покупкой.
Из чего собрать папку
В формате Agent Skills обязательным является SKILL.md с YAML-шапкой. Имя – до 64 символов из строчных латинских букв, цифр и дефисов, описание – до 1024 символов. Для Claude также не используйте зарезервированные слова claude и anthropic в имени. Описание должно объяснять действие и случаи применения. Шаблоны, справки и скрипты добавляйте только по необходимости.
weekly-client-report/
SKILL.md
references/metric-rules.md
assets/report-template.md
Пример собственной инструкции:
---
name: weekly-client-report
description: Собирает недельный отчёт клиенту по предоставленным данным. Применяй при просьбе подготовить итоги недели или статус работ для заказчика.
---
# Отчёт клиенту
1. Определи период и перечень исходных файлов.
2. Сопоставь показатели с правилами из references/metric-rules.md.
3. Пропуски пометь «нет данных». Не оценивай их на глаз.
4. Используй assets/report-template.md: сделано, показатели, проблемы, следующие действия.
5. Для каждой суммы укажи источник и единицу измерения.
6. Покажи черновик пользователю. Сам ничего не отправляй.
Если файлы противоречат друг другу, сначала задай вопрос.
Не выводи персональные сведения клиентов в общий отчёт.
Содержимое references/metric-rules.md для этого учебного примера:
# Правила показателей
- Период: даты начала и конца задаёт пользователь.
- Готовые работы: только задачи со статусом «принято» и датой внутри периода.
- Оплата: только подтверждённые поступления, с валютой из исходной таблицы.
- Возвраты показывай отдельно. Разные валюты не складывай.
- Если нет статуса, даты, валюты или подтверждения оплаты, перечисли пропуски.
- Не подменяй оплату суммой выставленных счетов.
Содержимое assets/report-template.md:
# Итоги за [даты]
## Выполнено
[Принятые работы со ссылками на исходные записи]
## Показатели
[Название, значение, единица, источник]
## Проблемы и вопросы
[Что мешает работе, кто должен ответить]
## Следующие действия
[Задача, ответственный и согласованная дата; неизвестное пометить]
## Что нужно уточнить
[Пропуски и противоречия]
Пять шагов до первого навыка
- Возьмите одну повторяющуюся задачу и несколько прежних хороших результатов.
- Запишите порядок работы, допустимые данные и типичные ошибки.
- Создайте файл, описание и один небольшой пример. Большие справки положите отдельно.
- Подключите папку способом, предусмотренным вашей средой.
- Испытайте на прямом запросе, другой формулировке той же задачи и посторонней просьбе. Проверьте выбор навыка и сам результат.
Запрос, который поможет подготовить файлы:
Помоги описать рабочий навык для [задача]. Сначала уточни, кто читает результат, какие материалы доступны, что нельзя делать и как я проверяю качество. Не выдумывай процессы компании. После ответов подготовь SKILL.md с name и description, кратким порядком работы и примером. Отдельно предложи три теста: подходящий запрос, переформулированный и неподходящий. Укажи, какие файлы мне ещё нужно предоставить.
Семь идей для работы
- Коммерческое предложение. Собрать черновик по брифу и утверждённому прайсу; спросить о пропущенных условиях.
- Протокол встречи. Отделить решения от обсуждения, выделить задачи и ответственных.
- Редактура. Проверить текст по словарю бренда и показать конкретные исправления.
- Ответ клиенту. Подготовить вариант по правилам поддержки, передать спор человеку.
- Бриф подрядчику. Выяснить цель, материалы, формат сдачи и критерии приёмки.
- Отчёт из таблицы. Проверить колонки, единицы и период перед расчётами.
- Приёмка работы. Пройти чек-лист, дать замечания со ссылками на проверенные места.
Перед установкой проверьте безопасность
Прочитайте инструкцию и все приложенные скрипты. Неожиданная загрузка файлов, сетевые запросы и отправка данных могут не иметь отношения к заявленной задаче. В инструкциях не должно быть паролей и ключей. Ограничьте права рабочего запуска и сначала используйте тестовые материалы.
Навык с кодом следует проверять как программу. У разных сред разные сетевые возможности. Для Skills в API Anthropic описывает контейнер без доступа к сети и установки новых пакетов во время исполнения. Это не означает, что любая установка Claude Code также изолирована. Отдельно проверьте политику хранения: режим Skills не следует автоматически считать совместимым с ZDR.
Шесть распространённых ошибок
- Описание без условий применения.
- Одна огромная инструкция вместо короткого порядка и отдельных справок.
- Сложный набор файлов ради разовой задачи.
- Ожидание автоматической синхронизации между продуктами.
- Установка чужого архива без чтения кода.
- Отсутствие теста на неправильное включение и ошибочный результат.
Нужен ли навык для каждого промпта? Нет: начните с действительно повторяющейся работы. Можно ли делиться? Да, с учётом способа распространения и прав среды; назначьте владельца версии. Гарантирует ли он качество? Нет, сохраните тесты и проверку результата. На разборе TRUE можно описать один процесс и решить, какие инструкции, данные и инструменты ему нужны.

