Работа со Skills

Что такое Skills

Skills (навыки) в Hermes Agent — это маркдаун-файлы с YAML-метаданными, которые содержат процедурные знания: как выполнять конкретные задачи. В отличие от памяти (memory), которая хранит факты и автоматически подгружается в каждую сессию, навыки загружаются по запросу и не расходуют токены до момента использования.

CLI-команды для работы со Skills

Все команды управления навыками доступны через hermes skills. Полный синтаксис:

Просмотр и поиск

Команда	Описание
hermes skills list	Показать все установленные навыки
hermes skills search QUERY	Поиск навыков в каталоге Hub (agentskills.io)
hermes skills browse	Просмотреть все доступные навыки в каталоге
hermes skills inspect ID	Предварительный просмотр навыка без установки

Установка и удаление

Команда	Описание
hermes skills install ID	Установить навык из каталога Hub или по прямой ссылке на SKILL.md (--name — задать имя вручную)
hermes skills uninstall N	Удалить навык, установленный из каталога

Примечание: параметр ID может быть идентификатором из каталога Hub (например, skillsio/research) или прямым URL вида https://…/SKILL.md. Если в YAML-метаданных файла нет поля name, используйте флаг --name my-skill для явного задания имени.

Обновление и проверка

Команда	Описание
hermes skills check	Проверить наличие обновлений для установленных навыков
hermes skills update	Обновить устаревшие навыки до последних версий

Публикация и кастомные источники

Команда	Описание
hermes skills publish PATH	Опубликовать навык в реестр (каталог Hub)
hermes skills tap add REPO	Добавить GitHub-репозиторий как источник навыков

Примечание: команда tap add позволяет использовать навыки из произвольного GitHub-репозитория, а не только из официального каталога Hub. Это удобно для организации собственных библиотек навыков внутри команды.

Конфигурация

Команда	Описание
hermes skills config	Включить/отключить навыки для конкретных платформ (CLI, Telegram, Discord и др.)

Slash-команды (в сессии)

Команды для работы со навыками прямо во время интерактивного чата:

Команда	Описание
/skill <name>	Загрузить конкретный навык в текущую сессию
/skills	Поиск и установка навыков через интерактивный интерфейс (CLI)

Поиск навыков

Команда skills_list

Чтобы найти подходящий навык, используйте команду skills_list. Она покажет все установленные навыки с описаниями. Агент сам определяет, какой навык нужен, на основе контекста запроса.

Skills Hub

Каталог навыков доступен на сайте agentskills.io. Там можно найти готовые навыки, созданные сообществом, и установить их одной командой. Для публикации собственного навыка используйте hermes skills publish PATH.

Установка навыков

Из каталога Hub

Для установки навыка из каталога выполните:

hermes skills install skillsio/name

После установки навык появляется в директории ~/.hermes/skills/ и сразу доступен агенту.

Из кастомного репозитория

Добавьте GitHub-репозиторий как источник:

hermes skills tap add owner/repo

После этого навыки из этого репозитория будут доступны для установки через hermes skills install.

По прямой ссылке

Можно установить навык напрямую по URL:

hermes skills install https://raw.githubusercontent.com/owner/repo/main/path/SKILL.md

Проверка установки

Чтобы убедиться, что навык установлен, выполните hermes skills list. Для управления доступностью на платформах используйте hermes skills config — откроется интерактивный интерфейс включения/отключения для каждой платформы.

Использование навыков

Автоматическое определение

Когда вы задаёте вопрос, Hermes анализирует контекст и автоматически загружает нужный навык. Загрузка использует прогрессивное раскрытие — сначала агент видит имя и описание, а полный контент загружается только при необходимости.

Явный вызов

Можно явно вызвать навык с помощью команды skill_view:

skill_view("my-skill")

Для доступа к вложенным файлам навыка:

skill_view("my-skill", "references/api-docs.md")

Загрузка в сессию

Slash-команда /skill <name> загружает навык в текущую сессию. Это полезно, когда нужно явно активировать конкретный набор инструкций.

Плагин-навыки

Некоторые плагины поставляют собственные навыки. Они не отображаются в общем списке и загружаются только явно через skill_view.

Создание своего навыка

Структура директории

Создайте папку в ~/.hermes/skills/имя-категории/имя-навыка/. Основной файл — SKILL.md. Опционально можно добавить подпапки: references/ для справочных материалов, templates/ для шаблонов и scripts/ для скриптов.

Формат SKILL.md

Файл начинается с YAML-метаданных (name, description, version, tags, category), после чего идёт тело навыка в маркдауне. Рекомендуемые секции:

• When to Use — когда применять навык
• Procedure — пошаговая инструкция
• Pitfalls — частые ошибки и их решения
• Verification — как проверить результат

Конфигурация навыка

Если навыку нужны внешние параметры (API-ключи и т.д.), объявите их в секции metadata.hermes.config. При первом использовании Hermes запросит значения и сохранит их в config.yaml.

Тестирование

Запустите hermes chat -q "/имя-навыка ваш запрос" для проверки работы навыка. Навык регистрируется автоматически — достаточно положить файл в директорию.

Управление на платформах

Команда hermes skills config открывает интерактивный TUI для управления доступностью навыков на разных платформах (CLI, Telegram, Discord и др.). Это позволяет ограничить определённые навыки конкретными контекстами.

Skills vs Memory

• Skills — процедурные знания («как сделать»), загружаются по запросу, могут быть большими
• Memory — фактические знания («что есть что»), подгружаются автоматически, должны быть компактными

Если информацию можно поместить в справочный документ — это навык. Если на стикер — это память.

Советы

• Сфокусированность: создавайте навыки для конкретных задач, а не «всего DevOps сразу»
• Доверяйте агенту: после сложных задач Hermes может предложить сохранить решение как навык — соглашайтесь
• Категории: используйте подпапки (devops/, research/) для организации навыков
• Обновляйте: если навык устарел, выполните hermes skills check для проверки обновлений и hermes skills update для обновления
• Публикуйте: полезные навыки можно опубликовать в каталог Hub командой hermes skills publish PATH
• Кастомные репозитории: используйте hermes skills tap add REPO для подключения внутренних библиотек навыков вашей команды