Скиллы Hermes Agent: как установить готовый навык и создать свой

Скилл — это сохранённая инструкция для агента. Достаточно один раз описать порядок выполнения задачи, и затем Hermes сможет применять его по команде /имя-скилла без повторных пояснений. Готовый навык устанавливается одной командой. Собственный можно оформить вручную в файле SKILL.md или создать с помощью /learn.

Если Hermes ещё не установлен, сначала прочитай руководство о том, что это за агент и как его установить, а затем возвращайся к скиллам.

Что означает «скилл» в Hermes Agent?#

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

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

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

Формат открыт и совместим со спецификацией Agent Skills. Поэтому навыки из других каталогов обычно подходят Hermes без изменения формата, хотя отдельному скиллу могут потребоваться дополнительные инструменты или ключи. При желании своим навыком можно поделиться.

Какие скиллы установлены и где их искать?#

Пример структуры каталогов:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

Обязателен только SKILL.md. Остальные файлы добавляют по необходимости: в references/ помещают подробные материалы, в scripts/ — вспомогательные программы, а в templates/ и assets/ — шаблоны и ресурсы.

Встроенные навыки помогают с повседневными задачами: поиском GIF, PDF и таблицами, а также с YouTube, GitHub и заметками. Полный перечень с описаниями доступен в каталоге встроенных скиллов. При выполнении hermes update Hermes также обновляет встроенные навыки и сохраняет внесённые в них изменения.

Как установить готовый скилл из каталога?#

1. Найди скилл в каталоге

   hermes skills search pdf
   

   Поиск охватывает все подключённые источники. Чтобы просмотреть каталог целиком, выполни hermes skills browse без фильтра.

2. Изучи карточку скилла

   hermes skills inspect anthropics/skills/skills/pdf
   

   В карточке указаны описание, источник и уровень доверия. Не устанавливай навык из незнакомого источника, предварительно не изучив эти сведения.

3. Установи скилл

   hermes skills install anthropics/skills/skills/pdf
   

   Hermes загрузит SKILL.md и связанные файлы, проверит их безопасность и сохранит в ~/.hermes/skills/. После установки навык можно вызвать командой /pdf. Если ему требуются дополнительные инструменты или ключи, они будут указаны в SKILL.md, а Hermes сообщит об этом во время установки.

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

Если проверка предупредила о риске, установку можно продолжить с --force, но сначала выясни, что именно обнаружено. Обойти вердикт «опасно» нельзя. Проверка не гарантирует полной безопасности, поэтому перед первым запуском чужого скилла прочитай его инструкции и связанные команды.

Как установить скилл с GitHub или по ссылке?#

Доступны три способа:

# 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, указав источник.

Как пользоваться установленным скиллом?#

Команды 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; после этого навыки удобно запускать с телефона.

Как создать свой скилл: что включить в SKILL.md?#

Возьми этот пример за основу и измени под свою задачу:

---
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/.

Если скиллу необходим API-ключ, укажи в шапке переменную required_environment_variables. Вписывать туда сам секрет не нужно: достаточно имени переменной. При первом запуске в локальном терминале Hermes запросит значение, а затем будет подставлять его автоматически. В мессенджере агент предложит настроить ключ локально. Поля platforms, config, blueprint и другие параметры описаны на странице создания скиллов в официальной документации.

Когда файл готов, выполни следующие действия:

1. Создай каталог скилла

   mkdir -p ~/.hermes/skills/weekly-review
   

   Имя каталога должно совпадать со значением name в шапке.

2. Сохрани SKILL.md

   Помести файл SKILL.md в созданную папку и добавь туда инструкцию. Можно начать с примера выше и адаптировать его.

3. Запусти скилл и проверь результат

   Отправь агенту /weekly-review и попроси подвести итоги недели. Если он выполняет описанные шаги, значит скилл работает.

Как создать скилл из готовых материалов с помощью /learn?#

/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 "подведи итоги моей недели через скилл weekly-review: сделано — отчёт и звонки, зависло — оплата хостинга"

Так документация предлагает проверить, выполняет ли агент сохранённые указания. Если этого не происходит, проверь три возможные причины. Во-первых, имя каталога или значение name в шапке может не совпадать с именем команды. Во-вторых, описание может быть слишком общим и не объяснять, в каких случаях применять навык; сформулируй description словами, которыми описывают саму задачу. В-третьих, возможно, папка находится не в ~/.hermes/skills/, поэтому Hermes её не обнаруживает. Учти, что --toolsets skills ограничивает набор инструментов при проверке: так можно оценить работу с инструкцией, но не зависимости скилла, например от внешних программ.

Команда hermes skills list в терминале покажет, какие навыки установлены.

Как обновлять или удалять скиллы?#

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 также удалит не изменённые тобой встроенные навыки.

Что делать, если скилл не устанавливается или не работает?#

Hermes также распознаёт скиллы в каталогах .hermes/skills/ и .agents/skills/ внутри Git-репозитория. Перед загрузкой репозиторий нужно отметить как доверенный, поскольку эти файлы содержат инструкции для агента. После этого скиллы доступны только в данном репозитории и проходят ту же проверку безопасности. Доверие достаточно настроить один раз.

С чего начать?#

Продолжить изучение можно с руководства о подключении Hermes Agent к Telegram, чтобы запускать скиллы с телефона, или с инструкции о круглосуточной работе агента на сервере, если нужны навыки по расписанию. Сравнение двух агентов приведено в материале OpenClaw или Hermes Agent.