Вы поставили Hermes Agent, запустили первый workflow, агент выполнил задачу. Дальше хочется, чтобы он работал под ваши сценарии: анализировал конкурентов, собирал семантику, проверял код по вашим же чек-листам. Можно писать Python-инструменты. А можно добавить skill — процедурную память агента в виде markdown-файла. Skills не требуют программирования, хранят пошаговые инструкции, триггеры и команды терминала. Агент загружает их сам при старте сессии и применяет, когда распознаёт задачу.
Разберём, что такое skills в Hermes Agent, как устроен формат SKILL.md, где взять готовые навыки и как создать свой. В конце покажем, когда нужна интеграция MCP-серверов вместо skills.
Что такое skills в Hermes Agent?
Skills — процедурная память Hermes Agent. Это markdown-файлы с метаданными в YAML-frontmatter, которые определяют, когда применять навык (триггерные фразы), что делать пошагово (процедура), на какие грабли не наступать (pitfalls) и как проверить результат (verification). Навыки хранятся в директории ~/.hermes/skills/ и автоматически загружаются при запуске новой сессии.
Skills расширяют агента без программирования. Вы не пишете Python-код для нового инструмента, а описываете workflow в markdown. Агент читает навык и применяет его, когда вы формулируете запрос, совпадающий с триггером. Навыки могут вызывать существующие инструменты Hermes — терминал, файлы, поиск, патчи, браузер — и комбинировать их по вашему сценарию.
Подход | Когда применять | Что требуется --- | --- | --- Skills | Переиспользуемый workflow из существующих инструментов; нужна процедура, а не новая функция | Markdown-файл с описанием Tools (Python) | Нужна новая функция, которой у Hermes нет: парсинг специфичного API, сложная логика, обработка данных | Python-код, интеграция в агента MCP-серверы | Нужен доступ к внешнему API или сервису через стандартный протокол; есть готовый MCP-сервер | Конфигурация в config.yaml, установка сервера
Как устроен skill: формат SKILL.md
Skill — это файл SKILL.md с YAML-метаданными в начале и четырьмя обязательными секциями: When to Use (когда применять), Procedure (что делать пошагово), Pitfalls (частые ошибки и ловушки) и Verification (как проверить результат). Дополнительно можно добавить вложенные файлы: templates, scripts, references, assets.
Минимальная структура SKILL.md:
---
name: keyword-research
description: Соберёт семантику по ключевому слову через бесплатные источники
when_to_use: Когда нужна семантика, список ключей или LSI для статьи
version: 1.0
---
# keyword-research
## When to Use
Загружай этот навык, когда пользователь просит собрать семантику, найти ключевые слова или LSI по теме для SEO-статьи.
## Procedure
1. Спросить у пользователя основной ключ (seed keyword).
2. Запустить поиск в Google через `search_web(query=<seed> + "related:")`.
3. Собрать suggested queries из результатов поиска.
4. Проверить каждый ключ через tools типа Ubersuggest API (если настроен) или вручную.
5. Отдать таблицу: ключ, частота (примерная), сложность.
## Pitfalls
- Google может заблокировать по rate limit, если запросов больше 10 за минуту. Ставь паузу между запросами.
- Бесплатные API (например, DataForSEO trial) дают ограниченные данные. Предупреди пользователя.
- Не используй платные API без явного разрешения пользователя.
## Verification
Проверь, что:
- Таблица содержит минимум 10 ключей.
- У каждого ключа есть примерная частота илиометка "нет данных".
- Нет дублей в списке.- YAML frontmatter: name, description, when_to_use, version.
- When to Use: триггерные фразы и сценарии, когда навык применяется.
- Procedure: пошаговая инструкция с вызовами инструментов и командами.
- Pitfalls: что может сломаться, на какие грабли наступают чаще всего.
- Verification: как проверить, что результат правильный.
Опциональные вложенные файлы:
- references/: документация API, примеры ответов, справочники.
- templates/: шаблоны конфигов, писем, отчётов.
- scripts/: bash/Python-скрипты, которые навык запускает через терминал.
- assets/: изображения, диаграммы, вспомогательные файлы.
Как добавить готовый skill
Готовые навыки живут на Skills Hub (agentskills.io) — открытом маркетплейсе, совместимом с десятками AI-агентов. Hermes из коробки содержит 100+ встроенных навыков, а дополнительные можно установить одной командой.
Список доступных навыков:
hermes skills listИнформация о конкретном навыке:
hermes skills info <имя-навыка>Установка навыка из Skills Hub по URL:
hermes skills install https://agentskills.io/skills/<username>/<skill-name>Примеры популярных навыков:
- GitHub PR workflow: чтение pull request, code review, оставление комментариев через gh CLI.
- Notion: создание страниц, добавление блоков, поиск по workspace.
- YouTube content: получение транскриптов, анализ комментариев, идеи для видео.
Навыки выполняют команды терминала и могут обращаться к файлам. Skills Hub не проходит обязательный code review. Перед установкой проверяй источник: читай SKILL.md, смотри, что делают команды в секции Procedure. Если навык требует API-ключи или токены, убедись, что он не передаёт их третьим сторонам.
Как создать свой skill: пошаговый туториал
Создавать skill стоит после того, как вы успешно решили сложную задачу (5+ вызовов инструментов), преодолели ошибки и нашли рабочий подход. Агент может предложить сохранить workflow как навык автоматически. Вручную навык создаётся в три шага.
Шаг 1: определить триггер и процедуру
Триггер — это фраза или сценарий, когда навык должен сработать. Процедура — последовательность действий с конкретными командами и вызовами инструментов.
Пример: вы регулярно анализируете конкурентов для SEO-статей. Триггер: "проанализируй конкурентов по ключу". Процедура: поиск топ-10 в Google, извлечение контента через web_extract, подсчёт слов, выделение H2/H3, таблица с результатами.
Шаг 2: создать директорию и SKILL.md
Структура директории:
~/.hermes/skills/
└── seo/
└── competitor-analysis/
├── SKILL.md
└── references/
└── serp-example.json
Пример SKILL.md для competitor-analysis:
---
name: competitor-analysis
description: Анализирует топ-10 конкурентов по ключу: объём текста, структура, H2/H3
when_to_use: Когда нужен SEO-анализ конкурентов для статьи
version: 1.0
---
# competitor-analysis
## When to Use
Загружай, когда пользователь просит проанализировать конкурентов по ключевому слову для SEO.
## Procedure
1. Запросить у пользователя ключевое слово.
2. Выполнить `search_web(query=<ключ>, limit=10)`.
3. Извлечь URL из результатов.
4. Для каждого URL выполнить `web_extract(urls=[<url>])`.
5. Подсчитать:
- Объём текста (символы без пробелов).
- Количество H2 и H3.
- Ключевые слова в заголовках (regex match).
6. Вернуть таблицу: URL, объём, H2, H3, ключи в заголовках.
## Pitfalls
- web_extract может упасть на некоторых сайтах (JS-рендеринг, блокировка). Оборачивай в try/catch.
- Некоторые сайты отдают 403. Пропускай их с пометкой "недоступен".
- Не парси больше 10 URL за раз — будет долго. Если нужно больше, спроси пользователя.
## Verification
- Таблица содержит минимум 7 строк из топ-10 (3 могут быть недоступны).
- У каждой строки заполнены объём и количество заголовков.
- Нет ошибок парсинга в финальном выводе.Шаг 3: протестировать и опубликовать
Проверь навык в новой сессии Hermes:
hermes chat
# В чате:
# "проанализируй конкурентов по ключу 'hermes agent skills'"Если навык отработал правильно, опубликуй его на Skills Hub:
hermes skills publish competitor-analysisПосле публикации навык становится доступен другим пользователям через agentskills.io.
Примеры skills для разных задач
Skills для SEO:
| Навык | Что делает | Инструменты |
|---|---|---|
| keyword-research | Собирает семантику и LSI по теме | search_web, web_extract |
| competitor-analysis | Анализирует топ-10: объём, структура, H2/H3 | search_web, web_extract |
| content-brief | Генерирует бриф для статьи на основе конкурентов | web_extract, read_file, write_file |
Skills для разработки:
| Навык | Что делает | Инструменты |
|---|---|---|
| tdd-cycle | Проводит TDD-цикл: тест → код → запуск → рефакторинг | write_file, terminal, patch |
| code-review | Проверяет PR по чек-листу: стиль, безопасность, тесты | read_file, search_files, terminal |
| git-workflow | Создаёт ветку, коммит, пуш и PR через gh CLI | terminal |
Skills для исследований:
| Навык | Что делает | Инструменты |
|---|---|---|
| twitter-monitoring | Мониторит X/Twitter по ключам, извлекает тренды | search_web, web_extract |
| content-analysis | Анализирует статью: структура, тезисы, цитаты | web_extract, read_file |
| citation-extractor | Извлекает цитаты и источники из PDF или HTML | web_extract, read_file |
Больше навыков доступно в официальном репозитории Hermes Agent (директория /skills/) и на Skills Hub.
Разбираем AI-агентов на практике
В канале — реальные кейсы автоматизации, цифры и рабочие связки. Без хайпа.
ПодписатьсяИнтеграция MCP-серверов: когда нужны tools, а не skills
Skills хороши для переиспользуемых workflows из существующих инструментов. Но если вам нужен доступ к API, которого у Hermes нет, или сложная логика, которую не описать процедурой, подключайте MCP-сервер. MCP (Model Context Protocol) — стандарт для интеграции внешних инструментов в AI-агентов. Hermes поддерживает MCP natively через stdio и HTTP.
Когда skills недостаточно:
- Нужен доступ к API, для которого нет готовой ноды (Gmail, Slack, GitHub API, filesystem).
- Требуется stateful operation (сессия, контекст между запросами).
- Сложная логика обработки данных, которую не выразить последовательностью команд.
- Высокая производительность: обработка больших объёмов данных.
Конфигурация MCP-сервера в config.yaml:
mcp_servers:
filesystem:
command: npx
args:
- -y
- "@modelcontextprotocol/server-filesystem"
- "/home/user/projects"
env:
NODE_ENV: production
gmail:
command: python
args:
- "-m"
- "mcp_server_gmail"
env:
GMAIL_CREDENTIALS: /path/to/credentials.jsonПосле конфигурации MCP-сервер запускается автоматически при старте Hermes, и его инструменты становятся доступны агенту.
Популярные MCP-серверы:
- Context7 MCP: интеграция с Context7 для управления контекстом.
- Filesystem MCP: доступ к файловой системе через MCP.
- Gmail MCP: отправка и получение писем через Gmail API.
- Slack MCP: публикация сообщений и чтение каналов Slack.
- GitHub API MCP: работа с issues, PR, repositories через GitHub API.
Подробнее про MCP-серверы, примеры конфигурации и создание своего сервера — в статье MCP Server — что это.
Troubleshooting: частые проблемы
Skill не загружается
- Проверь путь: навык должен лежать в ~/.hermes/skills/<category>/<skill-name>/SKILL.md.
- Проверь синтаксис YAML в frontmatter. Ошибка в отступах сломает парсинг.
- Перезапусти сессию Hermes. Skills загружаются только при старте.
Skill fails с cryptic error
- Проверь dependencies. Если навык использует CLI-инструменты (gh, docker, kubectl), они должны быть установлены.
- Посмотри логи: hermes chat --log-level debug.
- Проверь, что у Hermes есть доступ к файлам и директориям, которые упоминаются в Procedure.
Конфликт навыков
- Если два навыка срабатывают на один триггер, используй профили Hermes. Создай отдельный профиль для группы навыков: hermes profile create <name>.
- Навыки в профиле приоритетнее глобальных. Храни специализированные навыки в профилях.
FAQ
Заключение и следующие шаги
Skills — no-code способ расширить Hermes Agent под ваши задачи. Начните с готовых навыков из Skills Hub, протестируйте их в своих сценариях. Когда столкнётесь со сложной задачей, которую решили вручную, сохраните workflow как навык. Если одних skills недостаточно, подключите MCP-серверы для доступа к API.
Больше практики по AI-агентам
В канале разбираю кейсы автоматизации, показываю рабочие связки и делюсь цифрами. Без хайпа.
ПодписатьсяСмежные статьи:
- Hermes Agent — что это — базовый обзор агента, установка, первые шаги.
- MCP Server — что это — детали протокола, примеры серверов, создание своего.
- Курс по AI-агентам — где получить глубокую практику по агентам и автоматизации.
