Как создать свой skill и проверить качество

1. Выберите действие с ясной границей

Сформулируйте назначение: «проверить бриф перед передачей дизайнеру». Не объединяйте сразу поиск идей, переговоры, производство и публикацию. У этих работ разные входы, полномочия и критерии завершения.

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

2. Соберите примеры до инструкции

Возьмите несколько реальных, разрешённых к использованию брифов и обезличьте их при необходимости. Для каждого подготовьте ожидаемый разбор. Укажите не просто «плохо», а точную проблему: нет формата, противоречат даты, непонятен источник утверждения.

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

3. Создайте минимальный SKILL.md

Спецификация Agent Skills предусматривает файл SKILL.md с полями name и description в начале; дополнительные материалы можно хранить рядом. Описание должно объяснять назначение и условия применения, чтобы помощник мог выбрать процедуру по задаче.

Для нашего примера достаточно короткой структуры. Назовите навык brief-review, в описании укажите проверку редакционного брифа перед передачей в производство. Затем перечислите входные поля, порядок проверки и формат результата. Вынесите длинные эталоны в отдельные файлы. Не превращайте основной документ в архив всех возможных правил компании.

Сохраните пример ниже в .claude/skills/brief-review/SKILL.md, если используете навык в проекте Claude Code. Затем дайте ему полный и неполный бриф: одного успешного чтения файла недостаточно для проверки процедуры.

---
name: brief-review
description: Проверяет редакционный бриф перед передачей дизайнеру или в производство.
---

# Проверка брифа

Применяй при запросе проверить готовность редакционного брифа.

1. Найди цель, аудиторию, формат и приложенные источники.
2. Сопоставь существенные утверждения с источниками.
3. Укажи пропуски и противоречия. Не заполняй их догадками.
4. Верни статус, основания и конкретные вопросы.

Допустимые статусы: нужны сведения; готов к проверке человеком.
Не публикуй материал и не изменяй исходники.

Первоисточники: Agent Skills specification ↗ Claude Code: Extend Claude with skills ↗

4. Разделите правила и проверяемые операции

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

Если часть работы можно проверить обычной программой, выделите её отдельно. Например, наличие обязательных полей и корректность идентификатора не требуют творческого решения. Скрипт должен иметь понятный вход, выход и сообщение об ошибке. Модель может объяснить результат человеку, но не должна незаметно менять критерий проверки ради успешного статуса.

5. Прогоните навык на контрольном наборе

Официальный Skill Creator Anthropic помогает разрабатывать навыки и организовывать их оценку. Его можно использовать как помощника, но ожидаемые результаты и важность ошибок определяет владелец процесса.

Разделите примеры на рабочие и контрольные. По первым вы улучшаете инструкцию; вторые проверяют, переносится ли правило на новые входы. Сравните результат с обычным запросом без навыка. Если качество одинаково, преимущество может быть в удобстве повторения, но не заявляйте улучшение точности без наблюдений.

Сравнение по задаче · на телефоне таблицу можно листать

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

Первоисточники: Anthropic Skill Creator ↗

6. Исправляйте причину, а не добавляйте запреты подряд

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

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

7. Проверьте навык на материале реального процесса

В Thomas Münz качество выдачи зависит от связи товара, характеристик и изображения. По этому принципу можно проектировать навык проверки карточки, не приписывая проекту использование конкретного инструмента. В «Эрнике» полезна другая проверка: согласованность сценария и визуальных ориентиров между кадрами.

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

Источники и дата проверки

Проверено 15 октября 2026 года. Доступность функций зависит от продукта, аккаунта и региона; приведённые примеры запросов — рабочие заготовки для вашей проверки.

1. Agent Skills specification ↗Структура SKILL.md, name/description и вспомогательные материалы
2. Anthropic Skill Creator ↗Разработка навыков и оценка результатов
3. Claude Code: Extend Claude with skills ↗Путь навыка внутри проекта Claude Code