Agent Skill — это небольшой пакет, в котором записано, когда агенту его включать и как выполнять задачу. Установка навыка похожа на подключение библиотеки: вы запускаете чужие инструкции, а иногда и чужой код. Поэтому перед установкой нужен аудит и записанное решение.
Навык — это папка с обязательным файлом SKILL.md. В начале файла идёт YAML-шапка с именем и описанием, дальше инструкции. Рядом могут лежать scripts, references и assets. Проверьте шапку, текст инструкций, каждый скрипт, лицензию и живость проекта, запустите навык в изоляции и выберите один из трёх исходов: ставить как есть, форкнуть и сократить или отказаться.
Спецификация Agent Skills требует два поля в шапке: имя и описание. По обзору в документации Claude агент сначала знает только имя и описание каждого навыка, а полный текст подгружает, когда задача подходит. Поэтому описание работает как условие запуска, и по нему легко понять, что навык хочет перехватить.
Ситуация: команде нужен разбор PDF
Условный пример. В небольшой команде сотрудники каждый день разбирают PDF: договоры, акты, выписки. Один из них нашёл в официальном репозитории anthropics/skills навык для работы с PDF и предлагает поставить его всем. Репозиторий принадлежит Anthropic, и это хороший старт, но решение о том, что запускать на рабочих компьютерах, принимает ваша команда. Пройдём аудит по шагам.
Оговорка о честности. Я описываю порядок проверки, а не итог чтения конкретного коммита: содержимое репозитория меняется, и проверять нужно ту версию, которую вы открыли сами.
Аудит одного навыка
- Версиясохранить commit или release, который изучаете
- Шапка и описаниекогда навык включается и что обещает
- Текст SKILL.mdкакие действия и полномочия он запрашивает
- Скриптычто запускается, куда пишет, с кем общается
- Лицензия и поддержкаможно ли использовать и кто обновляет
- Изолированный запусктестовые файлы без рабочих токенов
Первым делом зафиксируйте версию. Берите конкретный commit или release, а не плавающую ветку main, особенно если навык попадёт в критический процесс. Дальше откройте SKILL.md. В шапке посмотрите, насколько точно описание: что за задача, при каких условиях запускать. Описание вроде «помогает делать всё лучше» значит, что агент будет включать навык слишком часто. Для PDF ожидается узкая формулировка про работу с файлами этого формата.
В тексте инструкций ищите скрытое расширение полномочий. Тревожные фразы: отправить данные во внешний сервис, игнорировать другие правила, изменить внешнюю систему без подтверждения. Затем откройте папку scripts, если она есть. Для навыка про документы там обычно лежат помощники для работы с файлами, и вам надо понять по каждому: какие команды он вызывает, куда записывает результат, обращается ли к сети, ставит ли зависимости при запуске, читает ли переменные окружения и пути за пределами рабочей папки. Скачивание и запуск неизвестного кода, команды удаления и широкие пути — основания остановиться.
| Что смотреть | Что должно быть понятно | Красный флаг |
|---|---|---|
| Описание | Когда запускать и какую задачу решает | Расплывчатое обещание без условий |
| Вход | Какие файлы и данные нужны | Неограниченный доступ «на всякий случай» |
| Скрипты | Команды, пути записи, сетевые адреса, зависимости | Скачивание и запуск неизвестного кода |
| Лицензия | Условия использования и изменения | Файл лицензии отсутствует или отличается от README |
| Поддержка | Дата последних изменений, владелец | Навык не обновлялся после смены инструментов, на которые опирается |
Лицензию читайте в самой папке навыка и в README репозитория: условия могут различаться между навыками одного репозитория. Из README anthropics/skills видно, что часть материалов открыта по Apache 2.0, а часть доступна только для просмотра, и сам README советует тщательно тестировать навыки перед критическими задачами. Для поддержки посмотрите дату последних изменений и ответы на вопросы пользователей. Число звёзд показывает внимание аудитории и качества инструкции не гарантирует.
Остаётся пробный запуск в изолированной папке с тестовыми файлами и без рабочих токенов. Прогоните три случая. Обычный: полный корректный вход, результат в нужном формате. Изменённый: другое имя файла, неполные данные, соседняя задача. Сложный: повреждённый PDF или конфликтующие данные. Хороший навык на последнем случае останавливается и объясняет, какое решение нужно от человека. Затем передайте навык коллеге без устных пояснений. Если результат держится на знаниях автора проверки, навык пока не готов к командной работе.
Решение
В конце аудита нужна одна из трёх записей. «Ставим как есть» подходит, когда скрипты прозрачны и не ходят в сеть, лицензия разрешает использование, а запуск в изоляции прошёл на всех трёх случаях. «Форкаем и сокращаем» выбирают, когда навык полезен, но содержит лишнее: скрипты для задач, которыми вы не пользуетесь, широкие права или зависимости, которые ставятся при запуске. «Отказываемся» остаётся для навыков с непонятным кодом, неясной лицензией или поведением, которое не удалось объяснить.
Для нашей условной команды с PDF я бы выбрал второй вариант: форк с закреплённым commit. В форке остаются SKILL.md и скрипты, которыми команда реально пользуется. Остальное удаляется, права сужаются до рабочей папки, а владельцем форка назначается конкретный сотрудник с датой следующей проверки. Решение записывается в одну строку вместе с адресом и версией репозитория. Этот выбор определяется условиями нашего примера, и при другом содержимом навыка итог может быть иным.
Общее правило
Навык — это код поведения агента. Его проверяют так же серьёзно, как стороннюю зависимость: читают всё, что он запускает, сужают права до минимума и закрепляют версию. Внутренний корпоративный навык требует ещё трёх вещей: владельца, дату последней проверки и происхождение правил. Без них агент не отличит актуальный процесс от файла, который забыли удалить год назад.
Откуда брать навыки
Начинать стоит с официальных репозиториев, где понятно, кто отвечает за код. anthropics/skills содержит официальные примеры: документы, дизайн, разработку, коммуникации. У OpenAI текущий каталог примеров для Codex находится в openai/plugins, где плагины объединяют skills, MCP, приложения и команды, а старый openai/skills помечен как устаревший. huggingface/skills помогает работать с моделями, датасетами и Hugging Face Hub. Навыки Vercel для веб-разработки лежат в vercel-labs/agent-skills, а менеджер установки и обновления — в отдельном vercel-labs/skills. Менеджер пакетов упрощает доставку и аудит за вас не делает. Совместимость, зависимости и сетевые действия проверяются в каждом навыке отдельно.
Следующий шаг
Возьмите один навык, который вы собирались поставить, и пройдите шесть шагов аудита с записью решения. Свои корпоративные навыки лучше писать по тому же шаблону. Как записать навык и проверить его на своей рабочей задаче, мы разбираем на третьей сессии корпоративной AI-программы. Когда метод стабилен, его связывают с данными и инструментами в рабочего агента: пример такого контура есть в статье «ИИ-агенты для бизнеса: разбор входящих счетов и расчёт окупаемости». Если нужна система под ключ, смотрите внедрение AI.
Источники
- Agent Skills — открытая спецификация.
- Claude Docs — Agent Skills overview.
- Anthropic — официальный репозиторий Agent Skills.
- OpenAI — текущий репозиторий Plugins.
- OpenAI — устаревший репозиторий Skills.
- Hugging Face Skills.
- Vercel Agent Skills и Vercel Skills CLI.
- Пример с командой и PDF условный. Порядок аудита описан общим образом, без пересказа конкретной версии файлов.
Вопросы и ответы
Чем навык отличается от обычного промпта?
Промпт живёт в диалоге. Навык оформлен как папка с описанием условий запуска, шагами работы и, при необходимости, скриптами и справочными файлами. Его можно версионировать, проверять и передавать коллегам.
Безопасно ли ставить навыки с GitHub?
Безопасность зависит от конкретного навыка. Официальный репозиторий снижает неопределённость по происхождению, а проверка скриптов, прав и лицензии остаётся на вас. Запускайте новый навык в изоляции и без рабочих токенов.
Что делать, если лицензия навыка непонятна?
Не использовать навык в рабочих процессах, пока не выяснена лицензия. Можно написать владельцу репозитория или собрать собственный навык по открытой спецификации.