🏠 Главная › user guide › software development hermes agent skill authoring

{/ Эта страница автоматически передается из навыков SKILL.md с помощью сайта/scripts/generate-skill-docs.py. Редактируйте исходный SKILL.md, а не эту страницу. /}

Авторские навыки агента Гермеса

Создание SKILL.md в репозитории: frontmatter, валидатор, структура.

Метаданные навыки
Источник Встроенный (установлен по умолчанию)
Путь навыки/разработка-программного обеспечения/гермес-агент-навыки-авторство
Версия 1.0.0
Автор Агент Гермес
Лицензия Массачусетский технологический институт
Платформы Linux, MacOS, Windows
Теги навыки, авторство, гермес-агент, конвенции, скилл-мд
Связанные навыки написание-планов, requesting-code-review

Справочник: полный SKILL.md:::информация

Ниже приведено полное определение навыков, которые Hermes загружает при активации этого навыка. Это то, что агент видит в качестве инструкций, когда навыки активны.

Создание навыков Гермес-Агент (в репозиториях)

Обзор

SKILL.md может располагаться в двух точках:

  1. Локально у пользователя: ~/.hermes/skills/<возможно-категория>/<имя>/SKILL.md — личное, не публикуется. Создается через skill_manage(action='create').
  2. В репозитории (этот навык как раз про этот случай): /home/bb/hermes-agent/skills/<категория>/<имя>/SKILL.md — фиксируется, звоня с пакетом. Используйте write_file + git add. skill_manage(action='create') НЕ работает с этим деревом.

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

Обязательный Frontmatter

Источник источника: tools/skill_manager_tool.py::_validate_frontmatter. Жесткие требования:

Форма, используемая всеми навыками в навыки/разработка программного обеспечения/:

---
name: my-skill-name               # строчные, дефисы, ≤64 символа (MAX_NAME_LENGTH)
description: Используйте, когда <триггер>. <однострочное поведение>.
version: 1.0.0
author: Hermes Agent
license: MIT
metadata:
  hermes:
    tags: [short, descriptive, tags]
    related_skills: [other-skill, another-skill]
---

«версия» / «автор» / «лицензия» / «метаданные» НЕ проверяются валидатором, но есть у всех аналогов — пропустите их, и ваши навыки будут популярными.

Ограничения по размеру

Структура, соответствующая аналогам

Каждый навык в репозитории примерно следует:

# <Название>

## Обзор
Один-два абзаца: что и зачем.

## Когда использовать
- Маркированные триггеры
- «Не использовать для:» контр-триггеры

## <Разделы по теме, специфичные для навыка>
- Часто используются таблицы быстрого доступа
- Блоки кода с точными командами
- Рецепты, специфичные для Hermes (тесты через scripts/run_tests.sh, пути ui-tui и т.д.)

## Типичные ошибки
Нумерованный список ошибок и их исправлений.

## Чек-лист проверки
- [ ] Список действий для проверки после выполнения

## Одношаговые рецепты (опционально)
Именованные сценарии → конкретные последовательности команд.

Не каждый раздел обязателен, но «Обзор» + «Когда использовать» + содержащее тело + ошибка — это минимум, чтобы навык ощущался как равный.

Размещение в каталогах

skills/<категория>/<имя-навыка>/SKILL.md

Категории, присутствующие в репозиториях (подтверждаются с помощью lskills/): autonomous-ai-agents, creative, data-science, devops, dogfood, email, games, github, leisure, mcp, media, mlops/*, ведение заметок, продуктивность, red-teaming, «исследования», «умный дом», «социальные сети», «разработка программного обеспечения».

Выберите ближайшую существующую величину. Не изобретайте новые категории высшего уровня без необходимости.

Рабочий процесс

  1. Изготовьте аналоги в верхней категории: ls skills/<категория>/ Прочитайте 2-3 файла SKILL.md, чтобы соответствовать тону и прогрессу.
  2. Проверьте ограничения валидатора в tools/skill_manager_tool.py, если не уверены.
  3. Напишите черновик с помощью write_file в skills/<категория>/<имя>/SKILL.md.
  4. Проверьте локально: python import yaml, re, pathlib content = pathlib.Path("skills/<категория>/<имя>/SKILL.md").read_text() assert content.startswith("---") m = re.search(r'\n---\s*\n', content[3:]) fm = yaml.safe_load(content[3:m.start()+3]) assert "name" in fm and "description" in fm assert len(fm["description"]) <= 1024 assert len(content) <= 100_000
  5. Git add + commit в активной ветке.
  6. Примечание: загрузка навыков ТЕКУЩЕЙ кэшированной сессии — skill_view / skills_list не увидят новые навыки до новой сессии. Это ожидаемо, не ошибка.

Перекрестные ссылки на другие навыки

metadata.hermes.related_skills оба дерева (skills/ в репозиториях и ~/.hermes/skills/) во время загрузки. Вы МОЖЕТЕ ссылаться на локальный навык пользователя из навыков в репозитории, но это не будет работать для других пользователей, которые клонируют репозиторий заново. Предпочитайте ссылаться только на навыки репозитория. Если часто уровень навыков сохраняется только в ~/.hermes/skills/, рассмотрите возможность его продвижения в репозиториях.

Редактирование существующих навыков в репозиториях

Типичные ошибки

  1. Использование skill_manage(action='create') для навыков в репозитории. Он записывает в ~/.hermes/skills/, а не в дерево репозитория. Используйте write_file для создания репозиториев.

  2. Входящий пробел перед ---. Валидатор сначала content.startswith("---"); Любая ведущая пустая строка или спецификация приводит к нужным проверкам.

  3. Слишком общее описание. Описания принципов начинаются с «Использовать, когда...» и сосредоточьте класс триггера, а не одну задачу. «Используйте, когда отлаживаете X» > «Отладка X».

  4. Забыли заблокировать автора/лицензию/метаданные. Недавно прошел валидатор, но есть у всех аналогов; пропуск делает навыки, похожие на незаконные.

  5. Написание навыка, дублирующего аналог. Перед созданием lskills/<категория>/ и ввода 2-3 аналога. Предпочитайте расширение существующего навыка создания узкого собрата.

  6. Ожидание, что текущая сессия увидит новые навыки. Не увидит. Загрузчик идей происходит при старте сессии. Проверьте в любой сессии или через skill_view, используя аналитический путь.

  7. Ссылки на навыки, которых нет в репозиториях. related_skills: [some-user-local-skill] работает для вас, но блокируется для других клонов. Предпочитайте только ссылки внутри репозитория.

Проверка чек-листа