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

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

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

В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись, чтобы не пропускать новое.

Что такое скилл в 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/ для шаблонов и файлов.

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

Как поставить готовый скилл из каталога?

1. Поищи по каталогу

   bash

   Скопировать

   hermes skills search pdf

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

2. Посмотри карточку скилла

   bash

   Скопировать

   hermes skills inspect skills-sh/anthropics/skills/pdf

   Карточка покажет описание, источник и уровень доверия. Не ставь чужой скилл, не прочитав карточку.

3. Поставь

   bash

   Скопировать

   hermes skills install skills-sh/anthropics/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://sharethis.chat/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 подключены внешние каталоги: skills.sh от Vercel, ClawHub и LobeHub, а также browse.sh - больше 200 скиллов под конкретные сайты. Скиллы из этих каталогов можно найти той же командой hermes skills search с указанием источника, например --source browse-sh.

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

Команды 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. Создай папку скилла

   bash

   Скопировать

   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 в терминале.

Скиллы - часть ИИ-клона: способ один раз записать, как ты выполняешь задачу, чтобы агент повторял это без напоминаний. На практикуме за три вечера разбираем и начинаем собирать под твои задачи связку ИИ-клон + Второй мозг + Контекст-инжиниринг. Эта связка помогает передать агенту твою логику работы и контекст задач. Записи эфиров в личном кабинете, доступ 30 дней.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 17–19 ноября  ·  2 000 ₽

Записаться →

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

hermes skills check      # что обновилось в источниках
hermes skills update     # подтянуть новые версии
hermes skills uninstall pdf   # удалить скилл из хаба

Чтобы удалить скилл, созданный вручную, удали его папку из ~/.hermes/skills/. Если ты правил чужой скилл под себя, update его не тронет - 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.

Полная схема вайб-кодинга за три вечера: ИИ-клон + Второй мозг + Контекст-инжиниринг. Записи эфиров в личном кабинете, доступ 30 дней.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 17–19 ноября  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email