# Скиллы Hermes Agent: как установить готовый навык и создать свой > Руководство по навыкам Hermes Agent: установка из каталога, GitHub или по ссылке, устройство файла SKILL.md и создание собственного скилла с помощью /learn. Source: https://ailoot.ai/blog/ru/hermes-agent-skills/ Canonical: https://ailoot.ai/blog/ru/hermes-agent-skills/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-117 Revision: sha256-b2c8c33166c99bdbffef6cd0499b6bce19254b77670a61a7e1a319d5e81987c8 Скилл — это сохранённая инструкция для агента. Достаточно один раз описать порядок выполнения задачи, и затем Hermes сможет применять его по команде `/имя-скилла` без повторных пояснений. Готовый навык устанавливается одной командой. Собственный можно оформить вручную в файле SKILL.md или создать с помощью `/learn`. Если Hermes ещё не установлен, сначала прочитай руководство [о том, что это за агент и как его установить](https://ailoot.ai/blog/ru/hermes-agent-install-setup/), а затем возвращайся к скиллам.
Практические руководства по использованию Ailoot собраны в [документации](https://ailoot.ai/docs/).
## Что означает «скилл» в Hermes Agent?
Ключевой вывод Скилл — это файл с указаниями для агента: какие действия выполнить, какие команды использовать, что учесть и каких ошибок избегать. Обычно он находится в `~/.hermes/skills/` и называется SKILL.md; рядом могут лежать вспомогательные материалы. После установки навык вызывается командой `/имя` в любом чате с агентом.
Промпт отправляют агенту сообщением, а скилл хранится отдельно, чтобы Hermes мог обратиться к инструкции и в будущих задачах. Агенту показываются названия и краткие описания навыков; полный текст он загружает только тогда, когда скилл подходит к запросу. Так инструкции не занимают контекст все одновременно. Скилл сам по себе не предоставляет новых инструментов или доступов — он объясняет, как пользоваться уже доступными. Для подключения внешнего сервиса применяют MCP, это отдельная тема. Если требуется точная программная логика, специальная авторизация или обработка потока событий, одного скилла недостаточно: понадобятся инструменты агента. Готовый скилл подойдёт для типовой задачи, если его инструкции соответствуют запросу, а источник заслуживает доверия. Создай собственный, если важно зафиксировать именно свой порядок действий, ограничения и формат результата. Если нужные материалы или описание процесса уже есть, но не хочется вручную создавать файл, воспользуйся `/learn`.

Скиллы — это документы с инструкциями, которые Hermes загружает только тогда, когда они нужны агенту.

Источник: официальная документация Hermes Agent, раздел о скиллах (перевод с английского).
Формат открыт и совместим со [спецификацией Agent Skills](https://agentskills.io/specification). Поэтому навыки из других каталогов обычно подходят Hermes без изменения формата, хотя отдельному скиллу могут потребоваться дополнительные инструменты или ключи. При желании своим навыком можно поделиться. ## Какие скиллы установлены и где их искать?
Ключевой вывод Обычно скиллы находятся в `~/.hermes/skills/` и распределяются по подпапкам-категориям. В нестандартном профиле или при заданной переменной HERMES_HOME путь может отличаться — его покажет `hermes config path`. Вместе с Hermes устанавливается множество встроенных скиллов, например для поиска по arXiv, работы с GitHub и документами. Их перечень выводит команда `hermes skills list`; также можно спросить об установленных навыках в чате.
Пример структуры каталогов: ``` ~/.hermes/skills/ ├── research/ │ └── arxiv/ │ ├── SKILL.md │ └── scripts/ ├── productivity/ │ └── pdf/ │ ├── SKILL.md │ └── references/ └── .hub/ ``` Обязателен только SKILL.md. Остальные файлы добавляют по необходимости: в `references/` помещают подробные материалы, в `scripts/` — вспомогательные программы, а в `templates/` и `assets/` — шаблоны и ресурсы. Встроенные навыки помогают с повседневными задачами: поиском GIF, PDF и таблицами, а также с YouTube, GitHub и заметками. Полный перечень с описаниями доступен в [каталоге встроенных скиллов](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog). При выполнении `hermes update` Hermes также обновляет встроенные навыки и сохраняет внесённые в них изменения. ## Как установить готовый скилл из каталога?
Ключевой вывод Открой каталог командой `hermes skills browse`, найди подходящий навык с помощью `hermes skills search`, изучи его карточку через `hermes skills inspect` и установи командой `hermes skills install`. Каждый скилл проверяется на безопасность; для официальных источников предупреждение о стороннем происхождении не появляется.
1. ### Найди скилл в каталоге ```bash hermes skills search pdf ``` Поиск охватывает все подключённые источники. Чтобы просмотреть каталог целиком, выполни `hermes skills browse` без фильтра. 2. ### Изучи карточку скилла ```bash hermes skills inspect anthropics/skills/skills/pdf ``` В карточке указаны описание, источник и уровень доверия. Не устанавливай навык из незнакомого источника, предварительно не изучив эти сведения. 3. ### Установи скилл ```bash hermes skills install anthropics/skills/skills/pdf ``` Hermes загрузит SKILL.md и связанные файлы, проверит их безопасность и сохранит в `~/.hermes/skills/`. После установки навык можно вызвать командой `/pdf`. Если ему требуются дополнительные инструменты или ключи, они будут указаны в SKILL.md, а Hermes сообщит об этом во время установки. Проверка безопасности выявляет попытки передать данные наружу, встроенные указания, влияющие на поведение агента, и команды, способные удалить или повредить файлы. У источников предусмотрены разные уровни доверия: | Уровень | Источник скилла | Поведение при установке | |----|----|----| | Встроенный | Поставляется вместе с Hermes | Уже установлен, дополнительных действий не требуется | | Официальный | Каталог optional-skills в репозитории Hermes | Устанавливается без предупреждения о стороннем источнике: `hermes skills install official/security/1password` | | Доверенный | Репозитории openai/skills, anthropics/skills, huggingface/skills, NVIDIA/skills | Проверка выполняется в более мягком режиме | | Остальные | Каталоги, сторонние репозитории GitHub и прямые ссылки | Появляется предупреждение и проводится полная проверка | Если проверка предупредила о риске, установку можно продолжить с `--force`, но сначала выясни, что именно обнаружено. Обойти вердикт «опасно» нельзя. Проверка не гарантирует полной безопасности, поэтому перед первым запуском чужого скилла прочитай его инструкции и связанные команды. ## Как установить скилл с GitHub или по ссылке?
Ключевой вывод Для установки с GitHub укажи владельца, репозиторий и путь командой `hermes skills install владелец/репозиторий/путь`. Также можно передать прямую ссылку на SKILL.md: Hermes загрузит и материалы, на которые ссылается файл. Собственный источник подключается через `hermes skills tap add` и затем доступен как обычный каталог.
Доступны три способа: ```bash # 1. Установить конкретный навык из репозитория GitHub; путь указывается после имени репозитория hermes skills install anthropics/skills/skills/pdf # 2. Установить по прямой ссылке на SKILL.md с сайта hermes skills install https://example.com/SKILL.md # 3. Добавить репозиторий как источник; укажи своего владельца и название репозитория hermes skills tap add myorg/skills-repo hermes skills install myorg/skills-repo/deploy-runbook ``` По прямой ссылке Hermes получает SKILL.md и только те файлы из служебных подпапок, которые в нём упомянуты. Остальное содержимое сайта не загружается. Ссылка сохраняется как источник, поэтому команда `hermes skills update` впоследствии обновит скилл по тому же адресу. Помимо GitHub, можно подключать внешние каталоги скиллов. Чтобы искать в них, используй ту же команду `hermes skills search`, указав источник.
Предупреждение Без токена GitHub ограничивает число запросов до 60 в час. Если поиск или установка завершились ошибкой из-за лимита, добавь `GITHUB_TOKEN` в `~/.hermes/.env`: это повысит лимит до 5000 запросов в час.
## Как пользоваться установленным скиллом?
Ключевой вывод После установки скилл вызывается командой `/имя-скилла`; допиши задачу в той же строке. Дополнительная активация не требуется. Вызовы работают в терминале, веб-панели и мессенджерах через шлюз. Одно сообщение может содержать до пяти скиллов. Часто используемую комбинацию можно объединить под одной командой.
Команды `hermes ...` вводятся в терминале, а `/имя-скилла` — в чате с агентом: в терминале, веб-панели или мессенджере. ``` /gif-search смешные коты /github-pr-workflow сделай PR для переделки авторизации ``` Если отправить `/имя-скилла` без описания задачи, Hermes загрузит инструкцию и попросит уточнить, что нужно сделать. Можно вызвать несколько скиллов подряд в одном сообщении — максимум пять; оставшийся текст будет заданием: ``` /github-pr-workflow /test-driven-development закрой issue 123 и открой PR ``` Для часто используемых сочетаний предусмотрены наборы скиллов, которые в Hermes называются bundles. Например, команда `hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development` объединит несколько навыков и позволит вызывать их через короткую команду `/backend-dev`. Все скиллы из набора должны быть предварительно установлены. Слеш-команды доступны и в Telegram при подключённом шлюзе. Настройка описана в руководстве [о подключении Hermes Agent к Telegram](https://ailoot.ai/blog/ru/hermes-agent-telegram-setup/); после этого навыки удобно запускать с телефона. ## Как создать свой скилл: что включить в SKILL.md?
Ключевой вывод Собственный скилл — это папка в `~/.hermes/skills/` с обязательным файлом SKILL.md. В начале файла задаются имя и описание, затем по разделам записываются условия применения, последовательность действий, типичные ошибки и способ проверки результата. Это обычный текст, программировать не нужно. Для простого навыка хватит одной папки и одного файла.

Скиллы — удобный способ расширить возможности Hermes Agent: их проще создавать, чем инструменты, они не требуют менять код агента, и ими можно делиться.

Источник: официальное руководство Hermes Agent по созданию скиллов (перевод с английского).
Возьми этот пример за основу и измени под свою задачу: ```markdown --- name: weekly-review description: Разбор недели — что сделано, что зависло, план на следующую version: 1.0.0 metadata: hermes: tags: [planning, review] --- # Разбор недели ## When to Use Когда пользователь просит подвести итоги недели или составить план на следующую. ## Procedure 1. Возьми список дел за неделю из файла, который дал пользователь, или попроси его прислать список. 2. Распредели дела по трём группам: завершённые, отложенные, новые. 3. Определи три приоритета на следующую неделю. ## Pitfalls - Не добавляй дела, которых нет в исходном списке. ## Verification Попроси пользователя подтвердить, что дела верно распределены между группами «завершённые», «отложенные» и «новые». ``` Текст между тройными дефисами — метаданные. Ключевые поля — `name` и `description`. Имя задаётся латиницей через дефис и используется как команда для вызова скилла. По `description` агент решает, относится ли навык к текущей задаче и нужно ли загрузить его инструкцию. Слишком расплывчатое описание может привести к тому, что подходящий скилл не будет выбран. После шапки размещаются разделы самой инструкции. `When to Use` описывает условия применения, `Procedure` — последовательность шагов, `Pitfalls` — типичные ошибки и способы их предотвратить, а `Verification` — проверку результата. Если текста много, подробности можно вынести в `references/`, чтобы загружать их только при необходимости; вспомогательные программы хранят в `scripts/`.
Совет Сначала опиши самый распространённый сценарий, а редкие ситуации добавь ближе к концу. Hermes читает файл сверху вниз, и такой порядок помогает беречь контекст.
Если скиллу необходим API-ключ, укажи в шапке переменную `required_environment_variables`. Вписывать туда сам секрет не нужно: достаточно имени переменной. При первом запуске в локальном терминале Hermes запросит значение, а затем будет подставлять его автоматически. В мессенджере агент предложит настроить ключ локально. Поля `platforms`, `config`, `blueprint` и другие параметры описаны на странице [создания скиллов](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) в официальной документации. Когда файл готов, выполни следующие действия: 1. ### Создай каталог скилла ```bash mkdir -p ~/.hermes/skills/weekly-review ``` Имя каталога должно совпадать со значением `name` в шапке. 2. ### Сохрани SKILL.md Помести файл `SKILL.md` в созданную папку и добавь туда инструкцию. Можно начать с примера выше и адаптировать его. 3. ### Запусти скилл и проверь результат Отправь агенту `/weekly-review` и попроси подвести итоги недели. Если он выполняет описанные шаги, значит скилл работает. ## Как создать скилл из готовых материалов с помощью /learn?
Ключевой вывод Команда `/learn` формирует скилл на основе готовых материалов. Передай ей каталог с документацией, ссылку, заметки или описание процесса своими словами. Hermes подготовит SKILL.md по принятому формату, а тебе останется проверить результат. Для книги или большого архива документов он может создать отдельные тематические файлы.
``` /learn документацию демонстрационного API в ~/projects/example-docs, особенно раздел про авторизацию /learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills /learn как я только что публиковал сайт на хостинг ``` Если ты только что прошёл с агентом сложный процесс, попроси `/learn` сохранить его в скилл, пока последовательность действий ещё видна в переписке. В следующий раз Hermes сможет выполнить её по сохранённой инструкции. Большую книгу, спецификацию или архив документов не получится уместить в один файл. Hermes создаст краткий SKILL.md с перечнем тем, а подробные материалы разложит по `references/`. Они не займут контекст, пока агенту не потребуется загрузить их для ответа. Если снова выполнить `/learn` по той же теме, команда дополнит существующий скилл вместо создания дубликата. ## Как проверить, что скилл работает?
Ключевой вывод Для проверки запусти `hermes chat --toolsets skills -q` и передай запрос по теме навыка — например, попроси сгруппировать список дел за неделю. Если агент соблюдает категории, заданные инструкцией, скилл работает. Если он отвечает как обычно, проверь имя файла, описание в шапке и расположение папки.
```bash hermes chat --toolsets skills -q "подведи итоги моей недели через скилл weekly-review: сделано — отчёт и звонки, зависло — оплата хостинга" ``` Так документация предлагает проверить, выполняет ли агент сохранённые указания. Если этого не происходит, проверь три возможные причины. Во-первых, имя каталога или значение `name` в шапке может не совпадать с именем команды. Во-вторых, описание может быть слишком общим и не объяснять, в каких случаях применять навык; сформулируй `description` словами, которыми описывают саму задачу. В-третьих, возможно, папка находится не в `~/.hermes/skills/`, поэтому Hermes её не обнаруживает. Учти, что `--toolsets skills` ограничивает набор инструментов при проверке: так можно оценить работу с инструкцией, но не зависимости скилла, например от внешних программ. Команда `hermes skills list` в терминале покажет, какие навыки установлены. ## Как обновлять или удалять скиллы?
Ключевой вывод Команда `hermes skills check` проверяет, появились ли новые версии установленных скиллов, а `hermes skills update` загружает обновления. Для удаления используй `hermes skills uninstall имя`. При обновлении локальные изменения сохраняются: Hermes пропускает файлы, которые ты редактировал. Чтобы восстановить исходную версию скилла из хаба, выполни `hermes skills update имя --force`, а для встроенного — `hermes skills reset имя --restore`.
```bash hermes skills check # проверка обновлений в источниках hermes skills update # установка новых версий hermes skills uninstall pdf # удаление скилла из хаба ``` Чтобы удалить созданный вручную навык, удали его каталог из `~/.hermes/skills/`. При обновлении изменённого скилла Hermes сравнивает хеши и пропускает файлы с локальными правками, чтобы сохранить твою работу. Для восстановления исходной версии из хаба выполни `hermes skills update имя --force`, а для встроенного навыка — `hermes skills reset имя --restore`. Обе команды заменят внесённые изменения, поэтому заранее сохрани свою версию. Если встроенные скиллы мешают в списке, команда `hermes skills opt-out` отключит их добавление при обновлениях. Вариант `opt-out --remove` также удалит не изменённые тобой встроенные навыки. ## Что делать, если скилл не устанавливается или не работает?
Ключевой вывод Частые причины проблем — лимит GitHub в 60 запросов за час, блокировка проверки безопасности и неправильное расположение файла. При превышении лимита добавь `GITHUB_TOKEN`. Если установку остановила проверка, изучи её вывод. Если Hermes не находит скилл, проверь каталог `~/.hermes/skills/`.
| Симптом | Возможная причина | Решение | |----|----|----| | При поиске или установке появляются ошибки лимита | Без токена GitHub допускает не более 60 запросов в час | Добавить `GITHUB_TOKEN` в `~/.hermes/.env` | | Установка остановлена | Проверка обнаружила потенциальный риск в скилле | Изучить вывод проверки при установке; установленный скилл можно перепроверить командой `hermes skills audit`. Если показано предупреждение, продолжить можно с `--force`; вердикт «опасно» обойти нельзя | | Скилл установлен, но команда `/имя` не работает | Имя вызова не совпадает или каталог расположен неверно | Выполнить `hermes skills list` и проверить содержимое `~/.hermes/skills/` | | Скилл отсутствует даже в перечне | В SKILL.md заданы ограничения по платформе или требуемым инструментам | Открыть SKILL.md и проверить поля `platforms` и `requires_*` | | После update новая версия не появилась | Локальные изменения файла защищены от перезаписи | Для скилла из хаба выполнить `update имя --force`, для встроенного — `reset --restore`; если важнее сохранить свою версию, ничего не менять | | Скиллы из стороннего репозитория не загружаются | Репозиторий нужно пометить как доверенный | Выполнить `hermes skills trust` внутри репозитория | Hermes также распознаёт скиллы в каталогах `.hermes/skills/` и `.agents/skills/` внутри Git-репозитория. Перед загрузкой репозиторий нужно отметить как доверенный, поскольку эти файлы содержат инструкции для агента. После этого скиллы доступны только в данном репозитории и проходят ту же проверку безопасности. Доверие достаточно настроить один раз. ## С чего начать?
Ключевой вывод Установи один готовый скилл из каталога — это делается одной командой. Затем передай в `/learn` свою часто используемую инструкцию и проверь получившийся навык на реальной рабочей задаче.
Продолжить изучение можно с руководства [о подключении Hermes Agent к Telegram](https://ailoot.ai/blog/ru/hermes-agent-telegram-setup/), чтобы запускать скиллы с телефона, или с инструкции [о круглосуточной работе агента на сервере](https://ailoot.ai/blog/ru/hermes-agent-vps-24-7/), если нужны навыки по расписанию. Сравнение двух агентов приведено в материале [OpenClaw или Hermes Agent](https://ailoot.ai/blog/ru/openclaw-vs-hermes-agent/).
### Источники - [Официальная документация Hermes Agent](https://hermes-agent.nousresearch.com/docs/) - [Система скиллов: устройство и применение](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) - [Создание скиллов](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) - [Каталог встроенных скиллов](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog) - [Каталог официальных дополнительных скиллов](https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog) - [Репозиторий Hermes Agent на GitHub](https://github.com/NousResearch/hermes-agent) - [Открытая спецификация Agent Skills](https://agentskills.io/specification)
Больше об Ailoot — на [ailoot.ai](https://ailoot.ai/).
## Вопросы и ответы ### Почему установленный skill не появился как slash-команда? Проверьте список установленных навыков, имя SKILL.md, поле name и папку skills активного профиля. Загрузку также могут блокировать ограничения платформы, инструментов или доверия к репозиторию. ### Проверяет ли ограниченный smoke-test навыка все зависимости? Нет. Тест только навыка проверяет загрузку и соблюдение инструкции. Инструменты, программы и ключи проверяются отдельно. Затем подтвердите один ограниченный реальный результат перед полным процессом. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.