Hermes Agent: как я использую скиллы для расширения возможностей агента

Скиллы в Hermes Agent — это готовые инструкции, которые расширяют возможности агента без написания кода. Один файл SKILL.md превращает Hermes из общего ассистента в специалиста по SEO, DevOps, маркетингу или любой другой задаче. В каталоге Hermes Skill Hub уже более 91 000 скиллов от сообщества, и каждый можно установить одной командой. В статье — как устроены скиллы, как их создавать и использовать на практике.

Что такое скиллы в Hermes Agent?

Скилл в Hermes Agent — это файл SKILL.md в формате открытого стандарта agentskills.io, который содержит инструкции, процедуры и контекст для выполнения конкретной задачи. В отличие от простого промпта, скилл структурирован: у него есть триггеры активации, пошаговые процедуры, секция «подводные камни» и проверка результата.

Скиллы работают по принципу прогрессивного раскрытия. Агент не загружает все скиллы сразу — это было бы расточительно по токенам. Вместо этого:

  • skills_list() — компактный список всех скиллов (~3 000 токенов). Загружается в начале сессии.
  • skill_view(name) — полное содержимое одного скилла. Загружается по запросу.
  • skill_view(name, path) — конкретный файл внутри скилла (скрипт, шаблон, справка).
  • Это означает, что даже если у вас установлено 200 скиллов, агент тратит токены только на те, которые реально нужны для текущей задачи.

    Где хранятся скиллы?

    Все скиллы живут в директории ~/.hermes/skills/. Это единственный источник правды. При установке Hermes встроенные скиллы копируются из репозитория. Скиллы из хаба и созданные агентом тоже попадают сюда.

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

    ~/.hermes/skills/
    ├── mlops/
    │   ├── axolotl/
    │   │   ├── SKILL.md           # Основные инструкции (обязательно)
    │   │   ├── references/        # Дополнительная документация
    │   │   ├── templates/         # Шаблоны выходных файлов
    │   │   └── scripts/           # Вспомогательные скрипты
    │   └── vllm/
    │       └── SKILL.md
    ├── devops/
    │   └── deploy-k8s/
    │       └── SKILL.md
    └── .hub/                      # Состояние Skill Hub
    

    Каждый скилл — это минимум один файл SKILL.md. Опционально можно добавить папки references/, templates/, scripts/ и assets/ для дополнительных материалов.

    Как установить скилл?

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

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

    Каталог Hermes Skill Hub содержит более 91 000 скиллов. Установка — одной командой:

    hermes skills install 
    

    Или через слэш-команду в чате:

    /skills install 
    

    Установка из Git-репозитория

    Многие авторы публикуют скиллы на GitHub. Установка через git clone:

    git clone https://github.com/author/skill-name.git ~/.hermes/skills/skill-name
    

    Или через npx:

    npx skills add author/skill-name --target ~/.hermes/skills
    

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

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

    Для ручного создания достаточно файла SKILL.md:

    ---
    name: my-skill
    description: Краткое описание того, что делает скилл
    version: 1.0.0
    ---
    
    # Название скилла
    
    ## Когда использовать
    Условия активации.
    
    ## Процедура
    1. Шаг первый
    2. Шаг второй
    
    ## Подводные камни
    - Известные проблемы и способы их обхода
    
    ## Проверка
    Как убедиться, что всё сработало.
    

    Как устроен формат SKILL.md?

    Формат SKILL.md — это YAML-фронтматтер плюс Markdown-тело. Фронтматтер содержит метаданные, тело — инструкции.

    Фронтматтер

    ---
    name: seo-writer
    description: "SEO-статьи: исследование ключевых слов, написание, публикация"
    version: 1.0.0
    platforms: [linux, macos]          # Опционально — ограничение по ОС
    metadata:
      hermes:
        tags: [seo, content, marketing]
        category: productivity
        requires_toolsets: [web]        # Скилл показывается только при наличии web-тулсета
        config:
          - key: seo.default_lang
            description: Язык по умолчанию для SEO-статей
            default: "ru"
    ---
    

    Поле description критически важно — именно по нему агент решает, какой скилл загрузить. Чем больше формулировок в описании, тем надёжнее агент выберет нужный скилл.

    Условная активация

    Скиллы могут автоматически появляться или скрываться в зависимости от доступных инструментов:

  • fallback_for_toolsets — скилл показывается только когда указанная тулсета недоступна. Пример: скилл для DuckDuckGo появляется, когда нет API-ключа для web_search.
  • requires_toolsets — скилл показывается только когда указанная тулсета доступна.
  • Это полезно для создания «запасных» скиллов, которые активируются только при необходимости.

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

    Вот несколько категорий с примерами реальных скиллов, которые доказали свою полезность.

    Дисциплина разработки

    Скилл obra/superpowers — это не один скилл, а целая методология. Он включает:

  • brainstorming — перед написанием кода агент выясняет требования и показывает их вам
  • test-driven-development — строгий RED-GREEN-REFACTOR, агент не напишет код без падающего теста
  • systematic-debugging — при любом баге сначала анализ, потом исправление
  • verification-before-completion — агент проверяет результат командами, прежде чем сказать «готово»
  • Работа с заметками

    Скилл obsidian от Steph Ango (CEO Obsidian) даёт агенту полный доступ к вашему хранилищу заметок. Агент может искать информацию в ваших записях, создавать новые заметки, обновлять существующие. Это превращает Obsidian из личной базы знаний в рабочую базу знаний агента.

    SEO и контент

    Набор seo-geo-claude-skills включает 20 скиллов для всего цикла работы с контентом: исследование ключевых слов, анализ конкурентов, написание статей, оптимизация, мониторинг позиций. Особенно интересна часть GEO (Generative Engine Optimization) — опимизация под AI-движки вроде Perplexity и ChatGPT search.

    Интеграции

    Composio подключает Hermes к Gmail, Google Sheets, Slack и другим SaaS-сервисам без ручной настройки OAuth. Два пути: CLI (легче по токенам) или MCP-сервер.

    Как создать свой скилл: пошаговая инструкция

    Шаг 1. Определите задачу

    Скилл имеет смысл, когда задача повторяется. Примеры:

  • Публикация SEO-статей на WordPress
  • Мониторинг блогов и RSS-лент
  • Создание презентаций в определённом стиле
  • Деплой проекта на сервер
  • Шаг 2. Напишите SKILL.md

    Начните с минимального файла. Важные секции:

  • Когда использовать — условия активации. Чем точнее, тем лучше.
  • Процедура — пошаговые инструкции с конкретными командами.
  • Подводные камни — проблемы, с которыми вы столкнулись. Эта секция экономит время в будущем.
  • Проверка — как убедиться, что задача решена.
  • Шаг 3. Добавьте скрипты (если нужно)

    Если часть работы можно автоматизировать, положите скрипт в папку scripts/:

    ~/.hermes/skills/my-skill/
    ├── SKILL.md
    └── scripts/
        └── publish.py
    

    В SKILL.md укажите, как вызывать скрипт:

    ## Процедура
    1. Запустить скрипт: `python3 SKILL_DIR/scripts/publish.py --arg value`
    

    Переменная SKILL_DIR автоматически подставляется агентом.

    Шаг 4. Проверьте и улучшите

    Используйте скилл,遇到了 проблемы — добавьте их в секцию «Подводные камни». Агент может обновить скилл автоматически через skill_manage(action='patch').

    Skill Hub: каталог из 91 000+ скиллов

    Hermes Skill Hub — это крупнейший каталог скиллов для AI-агентов. По состоянию на 2026 год в нём более 91 000 скиллов, из которых около 170 — встроенные и 91 000+ — от сообщества.

    Распределение по категориям:

    Категория Количество
    Other 83 365
    AI Agents 1 928
    Productivity 1 291
    Software Dev 648
    Business & Finance 561
    Security 462
    Creative 420
    Research 328
    Blockchain 293
    Data Science 266

    Каталог показывает новую логику работы с агентами. Раньше разговор шёл вокруг отдельных промптов. Сейчас люди оформляют удачные сценарии в скиллы, публикуют их, а другие собирают из этих модулей свои пайплайны.

    Внешние директории скиллов

    Если вы используете одни и те же скиллы в разных AI-инструментах, можно настроить внешние директории:

    # ~/.hermes/config.yaml
    skills:
      external_dirs:
        - ~/.agents/skills
        - /home/shared/team-skills
    

    Правила:

  • Новые скиллы создаются в ~/.hermes/skills/
  • Если скилл с таким именем есть и локально, и во внешней директории — локальный побеждает
  • Внешние директории — не защита от записи: если они доступны для записи, агент может их изменить
  • Несуществующие пути игнорируются без ошибок
  • Skill Bundles: группировка скиллов

    Если определённые скиллы всегда используются вместе, их можно объединить в бандл:

    hermes bundles create backend-dev \
      --skill github-code-review \
      --skill test-driven-development \
      --skill github-pr-workflow \
      -d "Backend feature work — review, test, PR workflow"
    

    После этого /backend-dev загрузит все три скилла одновременно.

    Скиллы и память агента

    Скиллы — это процедурная память агента. Они дополняют два других типа памяти:

  • Декларативная память (memory tool) — факты о пользователе, окружении, конвенциях
  • Эпизодическая память (session_search) — история прошлых сессий
  • Процедурная память (skills) — как делать конкретные вещи
  • Когда агент решает сложную задачу и находит нестандартный подход, он предлагает сохранить его как скилл. Это замкнутый цикл: опыт → инструкция → повторное использование → улучшение.

    FAQ

    Чем скилл отличается от промпта?

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

    Сколько скиллов можно установить?

    Технического ограничения нет. Из-за прогрессивного раскрытия даже 200 скиллов не перегружают контекст — агент загружает только нужные. На практике лучше держать 20–50 скиллов, которые реально используются.

    Можно ли использовать скиллы от Claude Code или Codex CLI?

    Да. Hermes совместим с открытым стандартом agentskills.io. Скиллы в формате SKILL.md работают в Hermes, Claude Code, Codex CLI, OpenCode и других агентах без изменений.

    Как агент создаёт скиллы автоматически?

    После сложной задачи (5+ вызовов инструментов), исправления нетривиального бага или обнаружения нестандартного рабочего процесса, агент предлагает сохранить подход как скилл через инструмент skill_manage. Вы можете согласиться или отказаться.

    Что делать, если скилл устарел?

    Агент обнаруживает это при использовании и обновляет скилл через skill_manage(action='patch'). Вы тоже можете редактировать скиллы вручную — это обычные Markdown-файлы.

    Ссылки

  • Документация: Skills System
  • Каталог встроенных скиллов
  • Hermes Skill Hub
  • Стандарт agentskills.io
  • Руководство по созданию скиллов