Перейти к содержанию

With Skills

На этой странице Навыки — это подгружаемые по требованию документы со знаниями, которые учат Hermes выполнять конкретные задачи — от генерации ASCII-арта до управления GitHub PR. Это руководство описывает их повседневное использование.

Полную техническую справку см. в Система навыков.

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

Каждая установка Hermes поставляется со встроенными навыками. Посмотрите, что доступно:

[code] # В любом чат-сеансе: /skills

# Или из CLI:
hermes skills list

[/code]

Отобразится компактный список с названиями и описаниями:

[code] ascii-art Генерация ASCII-арта с помощью pyfiglet, cowsay, boxes... arxiv Поиск и получение академических статей с arXiv... github-pr-workflow Полный жизненный цикл PR — создание веток, коммиты... plan Режим планирования — проанализировать контекст, написать markdown... excalidraw Создание диаграмм в рисованном стиле с помощью Excalidraw...

[/code]

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

[code] # Поиск по ключевому слову /skills search docker /skills search music

[/code]

Хаб навыков​

Официальные опциональные навыки (более объёмные или узкоспециализированные, неактивные по умолчанию) доступны через Хаб:

[code] # Просмотр официальных опциональных навыков /skills browse

# Поиск в хабе
/skills search blockchain

[/code]

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

Каждый установленный навык автоматически становится слэш-командой. Просто введите его название:

[code] # Загрузить навык и дать ему задачу /ascii-art Сделай баннер с надписью «HELLO WORLD» /plan Спроектируй REST API для приложения списка дел /github-pr-workflow Создай PR для рефакторинга аутентификации

# Только название навыка (без задачи) загружает его и позволяет описать, что нужно
/excalidraw

[/code]

Вы также можете вызывать навыки через естественный разговор — попросите Hermes использовать конкретный навык, и он загрузит его через инструмент skill_view.

Прогрессивное раскрытие​

Навыки используют токено-эффективный паттерн загрузки. Агент не загружает всё сразу:

  1. skills_list() — компактный список всех навыков (~3k токенов). Загружается при старте сеанса.
  2. skill_view(name) — полное содержимое SKILL.md для одного навыка. Загружается, когда агент решает, что ему нужен этот навык.
  3. skill_view(name, file_path) — конкретный файл из состава навыка. Загружается только при необходимости.

Это означает, что навыки не расходуют токены, пока не будут фактически использованы.

Установка из Хаба​

Официальные опциональные навыки поставляются с Hermes, но не активны по умолчанию. Установите их явно:

[code] # Установить официальный опциональный навык hermes skills install official/research/arxiv

# Установка из хаба в чат-сеансе
/skills install official/creative/songwriting-and-ai-music

# Установка однофайлового SKILL.md напрямую по HTTP(S) URL
hermes skills install https://sharethis.chat/SKILL.md
/skills install https://example.com/SKILL.md --name my-skill

[/code]

Что происходит:

  1. Директория навыка копируется в ~/.hermes/skills/
  2. Он появляется в выводе skills_list
  3. Он становится доступен как слэш-команда

tip Установленные навыки вступают в силу в новых сеансах. Если вы хотите сделать его доступным в текущем сеансе, используйте /reset для начала нового сеанса или добавьте --now, чтобы немедленно инвалидировать кэш подсказок (требует больше токенов на следующем шаге).

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

[code] # Проверить, что навык на месте hermes skills list | grep arxiv

# Или в чате
/skills search arxiv

[/code]

Навыки, предоставляемые плагинами​

Плагины могут включать собственные навыки, используя пространства имён (plugin:skill). Это предотвращает конфликты имён со встроенными навыками.

[code] # Загрузить навык плагина по полному имени skill_view("superpowers:writing-plans")

# Встроенный навык с тем же базовым именем не затрагивается
skill_view("writing-plans")

[/code]

Навыки плагинов не перечисляются в системной подсказке и не появляются в skills_list. Они опциональны — загружайте их явно, когда знаете, что плагин предоставляет такой навык. При загрузке агент видит баннер со списком смежных навыков из того же плагина.

О том, как включать навыки в свой собственный плагин, см. Создать плагин Hermes → Включить навыки.

Настройка параметров навыка​

Некоторые навыки объявляют необходимую конфигурацию в своих frontmatter-полях:

[code] metadata: hermes: config: - key: tenor.api_key description: "Tenor API key for GIF search" prompt: "Enter your Tenor API key" url: "https://developers.google.com/tenor/guides/quickstart"

[/code]

Когда навык с конфигурацией загружается впервые, Hermes запрашивает у вас значения. Они сохраняются в config.yaml в разделе skills.config.*.

Управляйте конфигурацией навыков из CLI:

[code] # Интерактивная настройка для конкретного навыка hermes skills config gif-search

# Просмотр всей конфигурации навыков
hermes config get skills.config

[/code]

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

Навыки — это просто markdown-файлы с YAML frontmatter. Создание занимает меньше пяти минут.

1\. Создайте директорию​

[code] mkdir -p ~/.hermes/skills/my-category/my-skill

[/code]

2\. Напишите SKILL.md​

~/.hermes/skills/my-category/my-skill/SKILL.md

[code] --- name: my-skill description: Brief description of what this skill does version: 1.0.0 metadata: hermes: tags: [my-tag, automation] category: my-category ---

# My Skill

## When to Use
Use this skill when the user asks about [specific topic] or needs to [specific task].

## Procedure
1. First, check if [prerequisite] is available
2. Run `command --with-flags`
3. Parse the output and present results

## Pitfalls
- Common failure: [description]. Fix: [solution]
- Watch out for [edge case]

## Verification
Run `check-command` to confirm the result is correct.

[/code]

3\. Добавьте вспомогательные файлы (опционально)​

Навыки могут включать вспомогательные файлы, которые агент загружает по требованию:

[code] my-skill/ ├── SKILL.md # Основной документ навыка ├── references/ │ ├── api-docs.md # Справочник API, который агент может просмотреть │ └── examples.md # Примеры входных/выходных данных ├── templates/ │ └── config.yaml # Шаблонные файлы, которые агент может использовать └── scripts/ └── setup.sh # Скрипты, которые агент может выполнять

[/code]

Ссылайтесь на них в вашем SKILL.md:

[code] For API details, load the reference: skill_view("my-skill", "references/api-docs.md")

[/code]

4\. Протестируйте​

Запустите новый сеанс и попробуйте ваш навык:

[code] hermes chat -q "/my-skill help me with the thing"

[/code]

Навык появляется автоматически — никакой регистрации не требуется. Поместите его в ~/.hermes/skills/, и он готов к работе.

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

Управление навыками по платформам​

Управляйте тем, какие навыки доступны на каких платформах:

[code] hermes skills

[/code]

Откроется интерактивный TUI, где можно включить или отключить навыки для каждой платформы (CLI, Telegram, Discord и т.д.). Полезно, когда нужно, чтобы определённые навыки были доступны только в конкретных контекстах — например, оставить навыки разработки вне Telegram.

Навыки vs Память​

И то, и другое сохраняется между сеансами, но служит разным целям:

Навыки Память
Что Процедурные знания — как делать что-то Фактические знания — что есть что
Когда Загружаются по требованию, только когда актуально Внедряются в каждый сеанс автоматически
Размер Могут быть большими (сотни строк) Должны быть компактными (только ключевые факты)
Стоимость Ноль токенов до загрузки Небольшая, но постоянная стоимость токенов
Примеры «Как развернуть на Kubernetes» «Пользователь предпочитает тёмную тему, живёт в PST»
Кто создаёт Вы, агент, или установлено из Хаба Агент на основе разговоров
Правило: Если вы поместили бы это в справочный документ — это навык. Если вы поместили бы это на стикер — это память.

Советы​

Держите навыки сфокусированными. Навык, который пытается охватить «весь DevOps», будет слишком длинным и слишком расплывчатым. Навык, который покрывает «развёртывание Python-приложения на Fly.io», достаточно конкретен, чтобы быть по-настоящему полезным.

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

Используйте категории. Организуйте навыки по поддиректориям (~/.hermes/skills/devops/, ~/.hermes/skills/research/ и т.д.). Это упрощает управление списком и помогает агенту быстрее находить нужные навыки.

Обновляйте навыки, когда они устаревают. Если вы используете навык и сталкиваетесь с проблемами, которые в нём не описаны, скажите Hermes обновить навык с учётом полученного опыта. Навыки, за которыми не следят, становятся обузой.

Полную справку по навыкам — поля frontmatter, условную активацию, внешние директории и другое — см. в Система навыков.