Добавьте /learn в Hermes Agent и забудьте о ручном SKILL.md

Itinai.com two developers coding side by side in a minimalist 9e46852c 56ad 43df b8ce 5a8451c13b63 2

Что такое система Skills в Hermes Agent?

Skills — это небольшие «справочники», которые агент загружает только в тот момент, когда они действительно нужны. Каждый навык хранится в отдельной папке с файлом SKILL.md, оформленным по открытой спецификации agentskills.io. Все навыки находятся в ~/.hermes/skills/ и становятся доступными как слеш‑команды: /plan, /axolotl и т.д.

Как работает команда `/learn`?

Раньше навыки приходилось писать вручную, теперь достаточно указать источник, а агент сам соберёт материал и сформирует SKILL.md. Он умеет:

чтать локальные каталоги (read_file, search_files);
выгружать онлайн‑документы (web_extract);
запоминать процедуры, которые вы только что прошли в диалоге.

Примеры команд:

/learn the REST client in ~/projects/acme-sdk, focus on auth + pagination
/learn https://docs.example.com/api/quickstart
/learn how I just deployed the staging server
/learn filing an expense: open the portal, New > Expense, attach receipt, submit

Почему навыки не «съедают» ваш бюджет?

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

Уровень 0 – skills_list(): список имён и коротких описаний (≈ 3 000 токенов).
Уровень 1 – skill_view(name): полное содержимое навыка.
Уровень 2 – skill_view(name, path): отдельный файл из навыка.

Таким образом, агент держит в контексте только индекс, а детали загружает по необходимости.

Разные способы создания навыка

Ручное написание SKILL.md – полный контроль, минимум автоматизации.
/learn – агент автоматически формирует навык из любого источника.
Автосохранение через skill_manage – после выполнения сложной задачи агент сохраняет использованный подход.
Установка из Skills Hub – готовые навыки от сторонних разработчиков.

Практические сценарии

Онбординг внутреннего API: /learn по URL приватных документов сразу создаёт навык с инструкциями по авторизации, пагинации и часто используемым вызовам. Новые сотрудники вызывают его как /my-api.
Фиксация runbook’а деплоя: после проведения ручного развертывания запускаете /learn how I just deployed the staging server — полученный навык можно повторять из любого интерфейса.
Группировка повторяющихся задач: через файл‑батч (см. пример ниже) собираете несколько навыков в один «bundle», который загружается одной командой.

Пример bundle‑навыка

Сохраните файл backend-dev.yaml в ~/.hermes/skill-bundles/ и получите команду /backend-dev, которая подтянет три навыка: review, test и PR.

name: backend-dev
description: Backend feature work — review, test, PR workflow.
skills:
  - github-code-review
  - test-driven-development
  - github-pr-workflow
instruction: |
  Always start by writing failing tests, then implement.

Структура файла `SKILL.md`

Ниже минимальный шаблон, который генерирует /learn. Все поля обязательны, порядок разделов фиксирован.

---
name: my-skill
description: Краткое описание (≤ 60 символов)
version: 1.0.0
platforms: [macos, linux]     # опционально
metadata:
  hermes:
    tags: [python, automation]
    category: devops
---

# My Skill

## When to Use
Условия, при которых навык применим.

## Procedure
1. Шаг один
2. Шаг два

## Pitfalls
- Возможные ошибки и их исправления

## Verification
Как проверить, что всё сработало.