🏠 Главная › guides › work with skills

Работа с навыками

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

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

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

Для каждой установки Hermes требуются внешние приложения. Посмотрите, что доступно:

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

# Или из CLI:
hermes skills list

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

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

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

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

Центр навыков

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

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

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

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

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

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

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

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

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

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

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

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

Установка из Hub

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

# Установить официальный опциональный скилл
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

Что происходит: 1. Директория навыков копируется в ~/.hermes/skills/ 2. Он появляется в выводе skills_list 3. Он становится доступен как слэш-команда.:::совет. Установленные навыки в школе на новых сеансах. Если вы хотите сделать его доступным в текущем сеансе, воспользуйтесь /reset для перезапуска или раздела --now, чтобы немедленно отключить кэш-промпту (это приведет к увеличению большего количества токенов на следующем шаге).

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

# Проверить, что скилл установлен
hermes skills list | grep arxiv

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

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

Плагины могут включать собственные навыки, используя пробелы в именах («плагин: навык»). Это наши конфликты с именами, потери с навыками.

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

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

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

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

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

Некоторые навыки заявляют о необходимости расчета на переднем плане:

metadata:
  hermes:
    config:
      - key: tenor.api_key
        description: "API-ключ Tenor для поиска GIF"
        prompt: "Введите ваш API-ключ Tenor"
        url: "https://developers.google.com/tenor/guides/quickstart"

Когда навыки настройки загрузки возникают впервые, Гермес задается вопросом. Они указаны в config.yaml в разделе skills.config.*.

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

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

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

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

Скиллы — это просто уценочные файлы с YAML-текстом. Создание занимает менее пяти минут.

1. Создать каталог

mkdir -p ~/.hermes/skills/my-category/my-skill

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

```markdown title="~/.hermes/skills/my-category/my-skill/SKILL.md"

name: my-skill description: Краткое описание того, что делает этот скилл version: 1.0.0 metadata: hermes: tags: [my-tag, automation] category: my-category

Мой скилл

Когда использовать

Используйте этот скилл, когда пользователь спрашивает о [конкретной теме] или ему нужно [выполнить конкретную задачу].

Процедура

  1. Сначала проверьте, доступно ли [предварительное условие]
  2. Выполните command --with-flags
  3. Разберите вывод и представьте результаты

Подводные камни

Проверка

Выполните check-command, чтобы убедиться, что результат корректен.

### 3. Добавьте справочные файлы (необязательно)

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

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

Ссылайтесь на них в своем SKILL.md:
```markdown
Для получения подробной информации об API загрузите справочник: `skill_view("my-skill", "references/api-docs.md")`

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

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

hermes chat -q "/my-skill помоги мне с этим"

Навык появляется автоматически — логин не требуется. Поместите его в ~/.hermes/skills/, и он готов к работе.:::информация Агент также может сам создавать и обновлять навыки с помощью Skill_manage. После решения сложных задач Гермес может предложить такой подход, как навыки для будущего использования.

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

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

hermes skills

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

Скиллы против Память

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

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

Эмпирическое правило: Если бы вы поместили это в справочный документ — это умение. Если бы вы написали это на стикере — это память.

Советы

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

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

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

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

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